DateTime es una función de texto que devuelve la fecha y la hora en que un informe se rellenará con datos. La fecha y hora se recuperan del servidor del informe y corresponden al país en el que se ubica dicho servidor. Se puede utilizar DateTime en un cuadro de texto, celda de texto o una cabecera de fila o columna.
Nota:
La zona horaria utilizada en los resultados de la función de texto al obtener la vista previa del informe se basa en la zona horaria de cada usuario especificada en Preferencias de usuario.
Sintaxis:
DateTime("DateFormat","TimeFormat")
Nota:
Si los parámetros de la función DateTime se dejan en blanco, por ejemplo, DateTime (), o si en ambos parámetros se utiliza "none", por ejemplo, DateTime (none, none), para el formato se utilizarán las preferencias del usuario de Narrative Reporting para Fecha y Hora.
Nota:
Consulte en Parámetros para funciones de texto las definiciones de parámetros.
De forma alternativa, se pueden especificar valores neutrales de configuración regional para formatos medios, largos y completos: DateTime (short|medium|long|full|none, short|medium|long|full|none). (No utilice comillas al introducir estos valores.) Ejemplos (se indican ejemplos para Estados Unidos):
DateTime(short, short): 01/03/2017 1:54 PM
DateTime(medium, medium): Jan 03, 2017 1:54:32 PM
DateTime(long, long): January 03, 2017 1:54:32 PM PDT
DateTime(full, none): Tuesday, January 03, 2017 (Nota: la hora no se muestra.)
DateTime(none, short): 1:54 PM (Nota: la fecha no se muestra.)
Tabla 10-9 Caracteres de formato de fecha y hora
| Caracteres de formato | Significado | Tipo de datos | Ejemplo |
|---|---|---|---|
|
G |
designador de era |
texto |
DC |
|
M |
mes del año |
texto o número |
Si el mes es julio: M mostrará: 7 MM mostrará: 07 MMM mostrará: Jul MMMM mostrará: julio |
|
d |
día del mes |
número |
10 |
|
h |
hora en am/pm (1-12) |
número |
11 |
|
H |
hora del día (0-23) |
número |
22 |
|
m |
minuto de la hora |
número |
30 |
|
s |
segundo del minuto |
número |
25 |
|
S |
milisegundo |
número |
978 |
|
E |
día de la semana |
texto |
E: Mar EE: Martes |
|
D |
día del año |
número |
189 |
|
F |
día de la semana del mes |
número |
Date("dd-MMM-yy ‘es el F 'º ' E 'de' ‘MMM") muestra: 24-Dic-02 es el 4º mar de dic |
|
w |
semana del año |
número |
27 |
|
W |
semana del mes |
número |
2 |
|
a |
marcador am/pm |
texto |
PM |
|
k |
hora del día (1-24) |
número |
23 |
|
K |
hora en am/pm (0-11) |
número |
En Estados Unidos, si la hora es 3:37 PM: 3 |
|
z |
zona horaria |
texto |
Hora estándar del Pacífico |
|
y |
año |
número |
2017,02 |
|
' |
texto literal |
texto |
Date(" D’º día de ’yyyy") muestra:105º día de 2017 |
|
' ' |
dos comillas simples para generar una única comilla simple |
texto |
Date("k:mm ‘O’’Clock’ a") muestra: 6:15 O’Clock PM El uso de 2 comillas simples para generar una comilla simple o un apóstrofo, como en O’Clock (O’’Clock). |
Consideraciones del uso de caracteres de formato:
El número o recuento de caracteres de formato determina el formato:
En el caso del texto, el uso de un número menor de cuatro letras de patrón implica el uso de una forma corta o abreviada, si existe.
Cuatro o más letras de patrón implican el uso del formato completo.
M o MM implica el uso del mes como número.
MMM implica el uso de una abreviatura de tres letras para el mes.
MMMM implica el uso del nombre del mes completo.
Por ejemplo, si la fecha es el 24 de abril:
Date("dd-M-yy") muestra 24-4-17
Date("dd-MM-yy") muestra 24-04-17
Date("dd-MMM-yy") muestra 24-Abr-17
Date("dd-MMMM-yy") muestra 24-Abril-17
En el caso de los números el número de letras de patrón es el número mínimo de dígitos. Los números más cortos se rellenan con ceros. El año es un caso especial. Si se utiliza "yy", se mostrarán los dos últimos dígitos del año; si se utiliza "yyyy," se mostrará el año con cuatro dígitos.
Por ejemplo, si el mes es febrero.
Date("MM-yyyy") muestra 02-2017
Todos los caracteres alfabéticos mayúsculas y minúsculas se consideran patrones, con independencia de si se designan como caracteres de formato.
Incluya el texto literal entre comillas simples. Para utilizar una única comilla en el texto literal, incluya el texto entre comillas simples y utilice dos comillas para el apóstrofo.
Por ejemplo, el formato para imprimir 4 o’clock es:
Date("hh 'o''clock' ")
Ejemplos:
| Formato de fecha | Resultado |
|---|---|
|
|
23/3/17 |
|
|
23-Mar-17 |
|
|
Tuesday, March 23, 2017 |
|
|
12:52:05 PM |
|
|
12:52:05 PM Eastern Standard Time |
|
|
Tuesday, March 23, 2017 AD time: 12:52:05 PM Eastern Standard Time |
|
|
12:00 PM, Eastern Standard Time Debe utilizar dos comillas simples para generar una única comilla simple en el texto con formato resultante. |