x

DATETRAN (indate, '(intype)', '([formatops])', 'lang', outlen, output)

donde:

indate

Es la fecha introducida (en formato de fecha) para dar formato. Note que el formato de fecha no puede ser un formato alfanumérico o numérico con opciones de muestra de fecha (formato de fecha de Legacy).

intype

Es una de las cadenas de carácter que siguen que indica los componentes de fecha introducidos y el orden en que los desea mostrar, encerrados entre paréntesis y comillas sencillas.

Estos son los tipos de entrada de componente único:

Tipo de entrada de componente único	Descripción
'(W)'	Sólo el componente de día de la semana (el formato original sólo debe tener el componente W).
'(M)'	Sólo el componente de mes (el formato original sólo debe tener el componente M).

Estos son los tipos de entrada de dos componentes:

Tipo de entrada de dos componentes	Descripción
'(YYM)'	Año de cuatro dígitos, seguido de mes.
'(YM)'	Año de dos dígitos, seguido de mes.
'(MYY)'	Componente de mes, seguido de año de cuatro dígitos.
'(MY)'	Componente de mes, seguido de año de dos dígitos.

Estos son los tipos de entrada de tres componentes:

Tipo de entrada de tres componentes	Descripción
'(YYMD)'	Año de cuatro dígitos, seguido de mes y día.
'(YMD)'	Año de dos dígitos, seguido de mes y día.
'(DMYY)'	Componente de día, seguido de mes y año de cuatro dígitos.
'(DMY)'	Componente de día, seguido de mes seguido y año de dos dígitos.
'(MDYY)'	Componente de mes, seguido de día y año de cuatro dígitos.
'(MDY)'	Componente de mes, seguido de día y año de dos dígitos.
'(MD)'	Componente de mes, seguido de día (derivado de la fecha de tres componentes, al ignorar el componente de año).
'(DM)'	Componente de día, seguido de mes (derivado de la fecha de tres componentes, al ignorar el componente de año).

formatops

Es una cadena de cero o más opciones de formato encerradas entre paréntesis y comillas sencillas. Los paréntesis y las comillas son obligatorios incluso cuando no se han especificado opciones de formato. Las opciones de formato caben dentro de las categorías siguientes:

• Opciones de supresión de ceros a la izquierda en números de mes o día. Nota: La supresión de ceros reemplaza los ceros a la izquierda por espacios en blanco.
• Opciones de traducción de componentes de mes o día a mayúsculas, de forma completa o abreviada, o a nombres con uso de mayúsc./minúsc. predefinido (mayúsculas y minúsculas o sólo minúsculas, en función del idioma).
• Opciones del delimitador de fechas y opciones de puntuación de fechas con comas.

La siguiente tabla lista las opciones válidas para suprimir los ceros a la izquierda en números de mes o día. Observe que el cero a la izquierda ha sido reemplazado por un espacio en blanco:

Opciones de formato	Descripción
m	Meses de cero suprimido (muestra los meses numéricos antes de octubre como del 1 al 9 en vez de 01 al 09).
d	Muestra los días anteriores al día diez de cada mes del 1 al 9, en vez de del 01 al 09.
dp	Muestra los días anteriores al día diez de cada mes del 1 al 9, en vez de del 01 al 09, con un punto después del número.
do	Muestra los días anteriores al día diez de cada mes del 1 al 9. Sólo en inglés (EN), muestra un sufijo ordinal (st, nd, rd o th) después del número.

Las opciones válidas de nombre de mes y día son:

Opciones de formato	Descripción
T	Muestra el mes como un nombre abreviado, sin puntuación y en mayúsculas.
TR	Muestra el mes como un nombre completo y en mayúsculas.
Tp	Muestra el mes como un nombre abreviado, seguido de un punto y en mayúsculas.
t	Muestra el mes como un nombre abreviado y sin puntuación. Dependiendo del código de idioma, el nombre aparece con la primera letra en mayúscula o con todo mayúsculas.
tr	Muestra el mes como un nombre completo. Dependiendo del código de idioma, el nombre aparece con la primera letra en mayúscula o con todo mayúsculas.
tp	Muestra el mes como un nombre abreviado seguido de un punto. El nombre aparece con la forma predefinida del idioma especificado (por ejemplo, todo minúsculas en francés y español, o mayúscula inicial en inglés y alemán).
W	Incluye un nombre abreviado de día de la semana al principio de la fecha mostrada, en mayúsculas y sin puntuación.
WR	Incluye un nombre completo de día de la semana al principio de la fecha mostrada, en mayúsculas.
Wp	Incluye un nombre de día de la semana abreviado al principio de la fecha mostrada, en mayúsculas y seguido de un punto.
w	Incluye un nombre abreviado de día de la semana al principio de la fecha mostrada, sin puntuación. El nombre aparece con la forma predefinida del idioma especificado (por ejemplo, todo minúsculas en francés y español, o mayúscula inicial en inglés y alemán).
wr	Incluye un nombre completo de día de la semana al principio de la fecha mostrada. El nombre aparece con la forma predefinida del idioma especificado (por ejemplo, todo minúsculas en francés y español, o mayúscula inicial en inglés y alemán).
wp	Incluye un nombre abreviado de día de la semana al principio de la fecha mostrada, seguido de un punto. El nombre aparece con la forma predefinida del idioma especificado (por ejemplo, todo minúsculas en francés y español, o mayúscula inicial en inglés y alemán).
X	Incluye un nombre abreviado de día de la semana al final de la fecha mostrada, en mayúsculas y sin puntuación.
XR	Incluye un nombre completo de día de la semana, en mayúsculas, al final de la fecha mostrada.
Xp	Incluye un nombre abreviado de día de la semana al final de la fecha mostrada, en mayúsculas y seguido de un punto.
x	Incluye un nombre abreviado de día de la semana al final de la fecha mostrada, sin puntuación. El nombre aparece con la forma predefinida del idioma especificado (por ejemplo, todo minúsculas en francés y español, o mayúscula inicial en inglés y alemán).
xr	Incluye un nombre completo de día de la semana al final de la fecha mostrada. El nombre aparece con la forma predefinida del idioma especificado (por ejemplo, todo minúsculas en francés y español, o mayúscula inicial en inglés y alemán).
xp	Incluye un nombre de día de la semana abreviado al final de la fecha mostrada seguido de un punto. El nombre aparece con la forma predefinida del idioma especificado (por ejemplo, todo minúsculas en francés y español, o mayúscula inicial en inglés y alemán).

Las opciones válidas de delimitador de fecha son:

Opciones de formato	Descripción
B	Utiliza un espacio en blanco como delimitador de componentes. Esta es la opción predeterminada cuando se traduce el mes o el día de la semana, o se usa la coma.
.	Utiliza un punto como el delimitador de componentes.
-	Utiliza un signo menos como delimitador de componentes. Esta es la opción predeterminada cuando no se reúnen las condiciones de delimitador en blanco predeterminado.
/	Utiliza una barra como delimitador de componentes.
|	Omite los delimitadores de componentes.
K	Utiliza los caracteres asiáticos correspondientes como delimitadores de componentes.
c	Coloca una coma después del nombre del mes (después de T, Tp, TR, t, tp o tr). Coloca una coma y un espacio en blanco después del nombre del día (después de W, Wp, WR, w, wp o wr). Coloca una coma y un espacio en blanco antes del nombre del día (después de X, XR, x o xr).
e	Muestra la palabra española o portuguesa de o DE entre el día y el mes y entre el mes y el año. El tamaño del nombre del mes determina el tamaño de la palabra de. Si se muestra el mes en mayúsculas, se muestra DE. De otra manera se muestra de. Útil para formatos DMY, DMYY, MY y MYY.
D	Introduce una coma después del número del día y antes del carácter delimitador general especificado.
Y	Introduce una coma después del año y antes del carácter delimitador general especificado.

lang

Es el código ISO estándar de dos caracteres para el idioma al que se debe traducir la fecha, entre comillas simples. Los códigos válidos de idioma son:

'AR' Árabe

'CS' Checo

'DA' Danés

'DE' Alemán

'EN' Inglés

'ES' Español

'FI' Finlandés

'FR' Francés

'EL' Griego

'IW' Hebreo

'IT' Italiano

'JA' Japonés

'KO' Coreano

'LT' Lituano

'NL' Holandés

'NO' Noruego

'PO' Polaco

'PT' Portugués

'RU' Ruso

'SV' Sueco

'TH' Tailandés

'TR' Turco

'TW' Chino (Tradicional)

'ZH' Chino (Simplificado)

outlen

Numérica

Es la longitud en bytes del campo de resultado. Si la longitud no es suficiente, se devuelve un resultado completamente en blanco. Si la longitud es mayor de lo necesario, se rellena el campo con espacios en blanco a la derecha.

output

Alfanumérico

Es el nombre del campo que contiene la fecha traducida o su formato encerrado entre comillas sencillas.

x

• El campo de resultado, aunque debe ser de tipo A y no AnV, puede contener información de longitud variable, ya que las longitudes de los nombres de mes y nombres de día pueden variar. También los números de mes y día pueden ser uno u dos bytes de longitud si se elige la opción de supresión de ceros. Los bytes no utilizados se rellenan de espacios en blanco.
• Todas las entradas inválidas e inconsistentes resultan en cadenas de salida completamente en blanco. Los datos no disponibles también devuelven salida en blanco.
• Las fechas base (1900-12-31 y 1900-12 o 1901-01) se manejan como si el ajuste DATEDISPLAY estuviese activado (es decir, no se muestran automáticamente como espacios en blanco). Para suprimir la impresión de fechas base, que tienen un valor de número entero interno de 0, busque el 0 antes de llamar a DATETRAN. Por ejemplo:

  RESULT/A40 = IF DATE EQ 0 THEN ' ' ELSE
                  DATETRAN (DATE, '(YYMD)', '(.t)', 'FR', 40, 'A40');

• Los componentes de fecha traducidos válidos se encuentran en archivos llamados DTLNGlng, donde lng es un código de tres caracteres, que indica el idioma. Estos archivos deben ser accesibles para cada idioma al que desea traducir fechas.
• Para que estos caracteres de NLS aparezcan correctamente, se debe configurar el servidor y cliente de WebFOCUS con las páginas de código correctas.
• La función DATETRAN no se apoya en Dialogue Manager.

Principio de página

Ejemplo: Cómo usar la función DATETRAN

La solicitud que sigue imprime el día de la semana en el caso predeterminado del idioma especifico:

DEFINE FILE VIDEOTRK
TRANS1/YYMD=20050104;
TRANS2/YYMD=20051003;

DATEW/W=TRANS1     ;
DATEW2/W=TRANS2    ;
DATEYYMD/YYMDW=TRANS1    ;
DATEYYMD2/YYMDW=TRANS2   ;
 

OUT1A/A8=DATETRAN(DATEW, '(W)', '(wr)', 'EN', 8 , 'A8') ;
OUT1B/A8=DATETRAN(DATEW2, '(W)', '(wr)', 'EN', 8 , 'A8') ;
OUT1C/A8=DATETRAN(DATEW, '(W)', '(wr)', 'ES', 8 , 'A8') ;
OUT1D/A8=DATETRAN(DATEW2, '(W)', '(wr)', 'ES', 8 , 'A8') ;
OUT1E/A8=DATETRAN(DATEW, '(W)', '(wr)', 'FR', 8 , 'A8') ;
OUT1F/A8=DATETRAN(DATEW2, '(W)', '(wr)', 'FR', 8 , 'A8') ;
OUT1G/A8=DATETRAN(DATEW, '(W)', '(wr)', 'DE', 8 , 'A8') ;
OUT1H/A8=DATETRAN(DATEW2, '(W)', '(wr)', 'DE', 8 , 'A8') ;
END

TABLE FILE VIDEOTRK
HEADING
"FORMAT wr"
""
"Full day of week name at beginning of date, default case (wr)"
"English / Spanish / French / German"
""
SUM OUT1A AS '' OUT1B AS '' TRANSDATE NOPRINT
OVER OUT1C AS '' OUT1D AS ''
OVER OUT1E AS '' OUT1F AS ''
OVER OUT1G AS '' OUT1H AS ''ON TABLE SET PAGE-NUM OFF
ON TABLE SET STYLE *
GRID=OFF, $
END

La salida es:

La solicitud que sigue imprime una fecha delimitada por espacios en blanco con un nombre de mes abreviado en inglés. Se suprimen los ceros a la izquierda en el número del día y se añade un sufijo al final del número:

DEFINE FILE VIDEOTRK
TRANS1/YYMD=20050104;
TRANS2/YYMD=20050302;

DATEW/W=TRANS1     ;
DATEW2/W=TRANS2    ;
DATEYYMD/YYMDW=TRANS1    ;
DATEYYMD2/YYMDW=TRANS2   ;

OUT2A/A15=DATETRAN(DATEYYMD,  '(MDYY)', '(Btdo)', 'EN', 15, 'A15') ;
OUT2B/A15=DATETRAN(DATEYYMD2, '(MDYY)', '(Btdo)', 'EN', 15, 'A15') ;
END

TABLE FILE VIDEOTRK
HEADING
"FORMAT Btdo"
""
"Blank-delimited (B)"
"Abbreviated month name, default case (t)"
"Zero-suppress day number, end with suffix (do)"
"English"
""
SUM OUT2A AS '' OUT2B AS '' TRANSDATE NOPRINTON TABLE SET PAGE-NUM OFF
END

La salida es:

La solicitud que sigue imprime una fecha delimitada por espacios en blanco con un nombre abreviado de mes en alemán. Se suprimen los ceros a la izquierda en el número del día y se añade un punto al final del número:

DEFINE FILE VIDEOTRK
TRANS1/YYMD=20050104;
TRANS2/YYMD=20050302;

DATEW/W=TRANS1     ;
DATEW2/W=TRANS2    ;
DATEYYMD/YYMDW=TRANS1    ;
DATEYYMD2/YYMDW=TRANS2   ;

OUT3A/A12=DATETRAN(DATEYYMD,  '(DMYY)', '(Btdp)', 'DE', 12, 'A12');
OUT3B/A12=DATETRAN(DATEYYMD2, '(DMYY)', '(Btdp)', 'DE', 12, 'A12');
END

TABLE FILE VIDEOTRK
HEADING
"FORMAT Btdp"
""
"Blank-delimited (B)"
"Abbreviated month name, default case (t)"
"Zero-suppress day number, end with period (dp)"
"German"
""
SUM OUT3A AS '' OUT3B AS '' TRANSDATE NOPRINTON TABLE SET PAGE-NUM OFF
END

La salida es:

La siguiente solicitud imprime una fecha delimitada por espacios en blanco, en francés, con un nombre de día completo al principio y un nombre mes completo, en minúscula (por defecto en francés):

DEFINE FILE VIDEOTRK
TRANS1/YYMD=20050104;
TRANS2/YYMD=20050302;

DATEW/W=TRANS1     ;
DATEW2/W=TRANS2    ;
DATEYYMD/YYMDW=TRANS1    ;
DATEYYMD2/YYMDW=TRANS2   ;

OUT4A/A30 = DATETRAN(DATEYYMD,  '(DMYY)', '(Bwrtr)', 'FR', 30, 'A30');
OUT4B/A30 = DATETRAN(DATEYYMD2, '(DMYY)', '(Bwrtr)', 'FR', 30, 'A30');
END

TABLE FILE VIDEOTRK
HEADING
"FORMAT Bwrtr"
""
"Blank-delimited (B)"
"Full day of week name at beginning of date, default case (wr)"
"Full month name, default case (tr)"
"English"
""
SUM OUT4A AS '' OUT4B AS '' TRANSDATE NOPRINTON TABLE SET PAGE-NUM OFF
END

La salida es:

La solicitud que sigue imprime una fecha en blanco delimitada en español con un nombre de día completo en minúsculas al principio (lo predeterminado en español), seguido por una coma y con la palabra de entre el número del día y mes y entre el mes y el año:

DEFINE FILE VIDEOTRK
TRANS1/YYMD=20050104;
TRANS2/YYMD=20050302;

DATEW/W=TRANS1     ;
DATEW2/W=TRANS2    ;
DATEYYMD/YYMDW=TRANS1    ;
DATEYYMD2/YYMDW=TRANS2   ;

OUT5A/A30=DATETRAN(DATEYYMD,  '(DMYY)', '(Bwrctrde)', 'ES', 30, 'A30');
OUT5B/A30=DATETRAN(DATEYYMD2, '(DMYY)', '(Bwrctrde)', 'ES', 30, 'A30');
END

TABLE FILE VIDEOTRK
HEADING
"FORMAT Bwrctrde"
""
"Blank-delimited (B)"
"Full day of week name at beginning of date, default case (wr)"
"Comma after day name (c)"
"Full month name, default case (tr)"
"Zero-suppress day number (d)"
"de between day and month and between month and year (e)"
"Spanish"
""
SUM OUT5A AS '' OUT5B AS '' TRANSDATE NOPRINTON TABLE SET PAGE-NUM OFF
END

La salida es:

La solicitud que sigue imprime una fecha en caracteres japoneses con un nombre de mes completo al principio, de tamaño predeterminado y con supresión de ceros:

DEFINE FILE VIDEOTRK
TRANS1/YYMD=20050104;
TRANS2/YYMD=20050302;

DATEW/W=TRANS1     ;
DATEW2/W=TRANS2    ;
DATEYYMD/YYMDW=TRANS1    ;
DATEYYMD2/YYMDW=TRANS2   ;

OUT6A/A30=DATETRAN(DATEYYMD , '(YYMD)', '(Ktrd)', 'JA', 30, 'A30');
OUT6B/A30=DATETRAN(DATEYYMD2, '(YYMD)', '(Ktrd)', 'JA', 30, 'A30');
END

TABLE FILE VIDEOTRK
HEADING
"FORMAT Ktrd"
""
"Japanese characters (K in conjunction with the language code JA)"
"Full month name at beginning of date, default case (tr)"
"Zero-suppress day number (d)"
"Japanese"
""
SUM OUT6A AS '' OUT6B AS '' TRANSDATE NOPRINTON TABLE SET PAGE-NUM OFF
END

La salida es:

La solicitud que sigue imprime una fecha delimitada por espacios en blanco en griego con un nombre de día completo al principio de tamaño predeterminado, seguido por una coma y con un nombre de mes completo en el tamaño predeterminado:

DEFINE FILE VIDEOTRK
TRANS1/YYMD=20050104;
TRANS2/YYMD=20050302;

DATEW/W=TRANS1     ;
DATEW2/W=TRANS2    ;
DATEYYMD/YYMDW=TRANS1    ;
DATEYYMD2/YYMDW=TRANS2   ;

OUT7A/A30=DATETRAN(DATEYYMD , '(DMYY)', '(Bwrctr)', 'GR', 30, 'A30');
OUT7B/A30=DATETRAN(DATEYYMD2, '(DMYY)', '(Bwrctr)', 'GR', 30, 'A30');
END

TABLE FILE VIDEOTRK
HEADING
"FORMAT Bwrctrde"
""
"Blank-delimited (B)"
"Full day of week name at beginning of date, default case (wr)"
"Comma after day name (c)"
"Full month name, default case (tr)"
"Greek"
""
SUM OUT7A AS '' OUT7B AS '' TRANSDATE NOPRINTON TABLE SET PAGE-NUM OFF
END

La salida es: