Date and Time Formats
A lo largo de sus proyectos 4D, es posible que necesite dar formato a los valores de fecha y/u hora en función de las especificidades de la aplicación, la plataforma o la interfaz.
4D incluye una lista completa de patrones que puede utilizar para crear y aplicar formatos personalizados de fecha y hora en sus aplicaciones, además de los formatos por defecto. Los patrones de formato personalizados son compatibles con las siguientes funciones:
- the
String
command, - the
OBJECT SET FORMAT
andOBJECT Get format
commands, - the date and time format form object properties, available from the Property list or the
dateFormat
andtimeFormat
JSON properties.
Lista de patrones
La siguiente tabla muestra todos los patrones soportados para formatos de fecha y hora.
Símbolo | Significado | Modelo | Ejemplo de salida |
---|---|---|---|
G | designador de era | G, GG o GGG | AD |
GGGG | Anno Domini | ||
GGGGG | A | ||
y | año | yy | 96 |
y o yyyy | 1996 | ||
Y | año de "Semana del año" | Y | 1997 |
u | año prolongado | u | 4601 |
Q | trimestre | Q | 2 |
02 | |||
QQQ | Q2 | ||
QQQQ | 2do trimestre | ||
QQQQQ | 2 | ||
q | trimestre independiente | q | 2 |
02 | |||
qqq | Q2 | ||
qqqq | 2do trimestre | ||
qqqqq | 2 | ||
M | mes en año | M | 9 |
MM | 09 | ||
MMM | Sept | ||
MMMM | Septiembre | ||
MMMMM | S | ||
L | mes independiente en año | L | 9 |
LL | 09 | ||
LLL | Sept | ||
LLLL | Septiembre | ||
LLLLL | S | ||
w | semana del año | w | 27 |
ww | 27 | ||
d | día del mes | d | 2 |
dd | 2 | ||
D | día del año | D | 189 |
E | día de la semana | E, EE o EEE | Tue |
EEEE | Tuesday | ||
EEEEE | T | ||
EEEEEE | Tu | ||
e | día de la semana local | e | 2 |
ee | 02 | ||
eee | Tue | ||
eeee | Tuesday | ||
eeeee | T | ||
eeeeee | Tu | ||
c | stand-alone local day of week | c o cc | 2 |
ccc | Tue | ||
cccc | Tuesday | ||
ccccc | T | ||
cccccc | Tu | ||
a | AM o PM | a, aa, o aaa | PM [abbrev] |
aaaa | PM [wide] | ||
aaaaa | p | ||
b | AM, PM, mediodía, medianoche | b, bb o bbb | mid. |
bbbb | medianoche | ||
bbbbb | md | ||
B | períodos de días flexibles | B, BB o BBB | at night [abbrev] |
BBBB | at night [wide] | ||
BBBBB | at night [narrow] | ||
h | hora en am/pm (1~12) | h | 7 |
hh | 07 | ||
H | hora en día (0~23) | H | 0 |
HH | 00 | ||
K | hora en am/pm (0~11) | K | 0 |
KK | 00 | ||
k | hora en día (1~24) | k | 24 |
kk | 24 | ||
m | minuto en hora | m | 4 |
mm | 04 | ||
s | segundo en minuto | s | 5 |
ss | 05 | ||
X | Time Zone: ISO8601 basic hm?, with Z for 0 | X | -08, +0530, Z |
Zona horaria: ISO8601 hm básico, con Z | XX | -0800, Z | |
Zona horaria: ISO8601 extendido hm, con Z | XXX | -08:00, Z | |
Zona horaria: ISO8601 hms básico, con Z | XXXX | -0800, -075258, Z | |
Zona horaria: ISO8601 hms extendido, con Z | XXXXX | -08:00, -07:52:58, Z | |
x | Time Zone: ISO8601 basic hm?, without Z for 0 | x | -08, +0530 |
Zona horaria: ISO8601 hm básico, sin Z | xx | -0800, +0000 | |
Zona horaria: ISO8601 hm extendido, sin Z | xxx | -08:00 | |
Zona horaria: ISO8601 hms básico, sin Z | xxxx | -0800, -075258 | |
Time Zone: ISO8601 extended hms?, without Z | xxxxx | -08:00, -07:52:58 | |
O | Time Zone: short localized GMT | O | GMT-8 |
Time Zone: long localized GMT (=ZZZZ) | OOOO | GMT-08:00 | |
z | Zona horaria: no específica | z, zz, o zzz | -0800 |
zzzz | GMT-08:00 | ||
zzzzz | -08:00, -07:52:58, Z | ||
' | escape para texto | ' | ' |
' ' | dos comillas simples producen una | ' ' | ' ' |
Explorar modelos
y
vs Y
y
es el año calendario, mientras que Y
es el año basado en el número de semana. Por ejemplo, si los primeros días de enero de 2010 no son la semana #1, entonces y = 2010 pero Y = 2009 (hasta la fecha en la que comienza la primera semana de 2010).
L
(monopuesto) vs M
En algunos idiomas (ruso, eslovaco), el mes utilizado por sí solo es diferente al mes en una fecha. In "January 10, 2010", "January" is not spelled the same as in "rendez-vous in January".
e
vs c
Same remark as for L
and M
: c
is for a day used alone "every tuesday") and e
is for a day in a date ("Tuesday January 15, 1951").
E
vs e
e
se basa en la configuración del sistema: si la semana está definida en el sistema como que comienza un miércoles, entonces el miércoles tendrá el valor numérico "1" (o cero) mientras que "E" siempre devuelve el mismo valor (de 1 a 7 o de 0 a 6).
Ceros a la izquierda
En general, cuando el número de letras de la cadena de formato es superior al esperado, se añaden ceros a la izquierda. Ej: "yyyyy" daría "001996".
Partes localizadas
Algunas partes de las salidas, como "medianoche" o "martes" están localizadas, según la configuración regional.
Por ejemplo, para la hora 13:25:34
, "B" aparecerá in the afternoon en un sistema estadounidense, y après-midi en un sistema francés.
Letras adicionales
Las cadenas de formato pueden contener caracteres que no deben interpretarse como caracteres de formato: si están entre "a" y "z" o "A" y "Z", deben ir entre comillas simples.
Por ejemplo:
"15:30:00" con el modelo "HH 'hours and' mm 'minutes'" produce "15 hours and 30 minutes".
Espacios iniciales y finales
Los espacios iniciales y finales de los modelos se recortan automáticamente en las salidas. Si desea añadir espacios antes o después de la cadena resultante, debe encerrarlos entre comillas simples.
Por ejemplo:
" HH : mm : ss " ---> "09 : 10 : 25" "' 'HH : mm : ss' '" ---> " 09 : 10 : 25 "
Ejemplos
Fecha u hora | Modelo | Result | Comentarios |
---|---|---|---|
15/06/2000 | "QQQQ" | "2do trimestre" | localizado |
17/03/2001 | "D" | "76" | 76º día del año |
17/03/1954 | "w" | "11" | 11ª semana del año |
17/03/1954 | "eeee" | "Miércoles" | localizado |
15:00:00 | "a" | "PM" | |
18:00:00 | "K a" | "6 PM" | |
13:30:15 | "hh:mm aa O" | "01:30 PM GMT+1" |
Ver también
Ver este blogpost para más información sobre los formatos personalizados de fecha y hora.