Date

Date es una función de texto que devuelve la fecha y hora en la que se han incluido los datos de un informe en línea, o la fecha y hora en la que se guardó un informe de instantáneas. Estos elementos se recuperan del servidor de informes y corresponden al país en el que esté ubicado dicho servidor. Puede utilizar Date en un cuadro o celda de texto, o en el encabezado de una fila o columna.

Nota:

El formato de fecha y hora varía según la configuración regional. Los ejemplos de este tema son ejemplos para Estados Unidos.

Sintaxis:

<<Date("format,TimeZoneId")>>

Argumento Descripción

format

Establece de forma predeterminada las preferencias de usuario de fecha y hora. Los valores válidos son aquellos aceptados por Java SimpleDateFormat, o bien "user" o ninguno ("user").

Los caracteres de format de fecha y hora distinguen entre mayúsculas y minúsculas.

TimeZoneId

Los valores válidos son aquellos aceptados por la clase Java TimeZone.getTimeZone(), o bien la zona horaria del servidor. Por ejemplo, en TimeZone.getTimeZone(), para especificar la Costa Este, escriba: "America/New_York".

Al utilizar TimeZoneID, entrecomille el parámetro format. Esto solo se aplica cuando se indica TimeZoneId. No es necesario actualizar los informes anteriores a la mejora de TimeZoneId .

Tabla -14 Caracteres de formato de fecha y hora

Caracteres de formato Significado Tipo de dato Ejemplo

G

designador de era

texto

AD

M

mes del año

texto o número

Si el mes es julio: M muestra: 7 MM muestra: 07 MMM muestra: Jul MMMM muestra: Julio

d

día del mes

número

10

h

hora en formato a. m./p. m. (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 en el mes

número

<<Date("dd-MMM-yy ‘is the’ F 'th ' E 'of' ‘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 a. m./p. m.

texto

p.m.

k

hora del día (1-24)

número

23

K

hora en formato a. m./p. m. (0-11)

número

Si la hora es 3:37 PM: 3

z

zona horaria

texto

Hora estándar del Pacífico

y

año

número

2002,02

'

texto literal

texto

<<Date(" D’the day of ’yyyy")>> muestra: el día 105 de 2002

' '

dos comillas simples que producen una comilla simple

texto

<<Date("k:mm ‘O’’Clock’ a")>> muestra: 18:15

Nota:

Utilice dos comillas simples para generar una comilla simple o un apóstrofe, como en O'Clock (O''Clock).

Consideraciones al utilizar caracteres format:

  • El número o el recuento de los caracteres format determinan el formato:

    • En el caso del texto, usar menos de cuatro letras de patrón implica una forma abreviada, si existe.

    • Cuatro o más letras de patrón implican usar la forma completa.

    • M o MM significan utilizar el mes como un número.

    • MMM significa que se utiliza la abreviatura de tres letras para el mes.

    • MMMM significa que se utiliza el nombre completo del mes.

    Por ejemplo, si la fecha es el 24 de abril:

    <<Date("dd-M-yy")>> muestra 24-4-02

    <<Date("dd-MM-yy)>> displays 24-04-02

    <<Date("dd-MMM-yy")>> muestra 24-Abr-02

    <<Date("dd-MMMM-yy")>> muestra 24-Abril-02

  • En el caso de los números, la cantidad de letras de patrón es el número mínimo de dígitos. Los números más breves se rellenan con ceros. El año es un caso especial. Si utiliza "yy", se mostrarán los últimos dos dígitos del año pero, si utiliza "yyyy", se mostrará el año con los cuatro dígitos.

    Por ejemplo, si el mes es febrero:

    <<Date("MM-yyyy")>> muestra 02-2002

  • Todos los caracteres alfabéticos en mayúsculas y minúsculas se consideran patrones, independientemente de si son o no caracteres format.

  • Redacte el texto literal entre comillas simples. Para utilizar comillas simples en texto literal, escriba dicho texto entre comillas simples y utilice dos comillas simples más para el apóstrofe.

    Por ejemplo, el formato para imprimir 4 o'clock es:

     <<Date("hh 'o''clock' ")>>

Ejemplos:

Formato de fecha Resultado

<<Date("d/M/yy")>>

23/3/02

<<Date("d-MMM-yy")>>

23-Mar-02

<<Date("EEEE, MMMM dd, yyyy")>>

Martes, Marzo 23, 2002

<<Date("h:mm:ss a")>>

12:52:05 PM

<<Date("h:mm:ss a zzzz")>>

12:52:05 PM Hora Estándar Este

<<Date("EEEE, MMMM dd, yyyy G 'time:' h:mm:ss a zzzz")>>

Martes, Marzo 23, 2002 AD hora: 12.52.05 PM Hora Estándar Este

<<Date("hh 'o’’clock' a, zzzz")>>

12:00 p.m., Hora Estándar Este

Nota:

Utilice dos comillas simples para generar una comilla simple en el texto del resultado con formato.