IBM FileNet P8, Version 5.2.1            

Máscaras de fecha/hora

Una máscara de fecha/hora puede tener dos fines: determina el formato de la salida de varias funciones o guía la conversión de una representación de serie de un valor en la forma interna de dicho valor.

A continuación se indican las dos formas en que se puede utilizar una máscara de fecha/hora:

  • Determina el formato de la salida de diversas funciones. Por ejemplo, en la función timetostring, la máscara de fecha/hora indica el formato que se utiliza para la salida de la serie. Si la máscara de fecha/hora es "hh:tt:ss" y el valor de tiempo es equivalente a 24 segundos después de las 9:12 a.m., la salida de la serie es 09:12:24.
  • Guía la conversión de una representación de serie de un valor en la forma interna de dicho valor. Por ejemplo, en la función stringtotime, la máscara de fecha/hora indica el formato de la serie de salida para que se convierta correctamente en un valor de tiempo. Si la serie de entrada es "05/06/1995", la máscara de fecha/hora "mm/dd/yyyy" indica que la subserie "05" representa el mes y no el día.

Una máscara de fecha/hora es una expresión de serie que contiene cualquier combinación válida de componentes y, opcionalmente, separadores. Dado que la máscara de fecha/hora es una serie, debe rodearla de comillas.

Para obtener ejemplos de uso, consulte los ejemplos de máscaras de fecha/hora.

Componentes

A continuación tiene los componentes permitidos en una máscara de fecha/hora. Cuando es aplicable, se enumera el intervalo válido para cada componente.

Tabla 1. Tabla de componentes de máscara de fecha/hora
Componente Significado
dd Día, con dos dígitos, del mes (1-31).
ddd Día, con tres dígitos, del año (1-366).
mm Mes, con uno o dos dígitos (1-12).
mon Abreviatura, con tres letras, del mes (Jan-Dec).
month Nombre completo del mes (January-December).
yy Año, con dos dígitos (00-99).

Le recomendamos que utilice el componente de cuatro dígitos (yyyy) en lugar del componente de dos dígitos. Con el componente de dos dígitos, internamente se asume que los dos primeros dígitos son "20" y puede que esa no sea su intención. Además, el uso del componente de cuatro dígitos identifica claramente el siglo y elimina cualquier problema de ambigüedad.

yyyy Año, con cuatro dígitos (0000-9999).
w Día de la semana, con un dígito (0-6, 0 = Sunday, 6 = Saturday).
day Abreviatura, con tres letras, del día (Sat-Sun).
dayname Nombre completo del día (Sunday-Saturday).
hh Hora del día (0-23).
tt Minuto de la hora (0-59).
ss Segundo del minuto (0-59).
am Indica si la hora es am o pm (en oposición al reloj de 24 horas).
xs:datetime

Indica la fecha y la hora en formato XML tal y como se describe en W3C XML Schema y ISO 8601. El formato es:

CCYY-MM-DDThh:mm:ss

Todos los campos deben estar presentes y, opcionalmente, pueden estar precedidos por un signo y cifras, si es necesario, y seguidos por dígitos fraccionados para los segundos y una zona horaria. La zona horaria se puede especificar utilizando la letra "Z", que identifica el UTC, o por la diferencia de hora con el UTC.

Separadores

Los símbolos siguientes son separadores válidos. El uso de separadores es opcional.

Tabla 2. Tabla de símbolos de separador válidos
Símbolo separador Símbolo separador Símbolo separador
, . /
- < >
? : |
^ ; "
[ ] {
} _ =
@ % +
( ) *
& # <space>

Ejemplos

En todos los ejemplos, la hora es equivalente a:
  • Miércoles, 8 de junio de 2000, 32 segundos después de las 2:05 p.m.
Tabla 3. Tabla de máscaras de fecha hora y resultados para el ejemplo
Máscara Resultados
"mon. dd, yyyy"
Jun. 8, 2000
"month dd, yyyy"
June 8, 2000
"mon dd, yy (day)"
Jun 8, 00 (Wed)
''hhttss"
140532
"hh:tt am"
02:05 pm
"dd-mm-yy, hh:tt"
8-6-00, 14:05
"mm/dd/yyyy, hh:tt:ss am"
6/8/2000, 02:05:032 pm
"ddd, hh:tt:ss"
167, 14:05:32
"tt:ss am"
05:32 pm
"xs:datetime"
2000-06-08T14:05:32


Last updated: October 2015
bpfe019.htm

© Copyright IBM Corp. 2015.