x

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

dove:

indate

Data di immissione (in formato data) da formattare. Si noti che il formato data non può essere un formato alfanumerico o numerico con opzioni di visualizzazione della data (formato data legacy).

intype

Una delle seguenti stringhe di caratteri che indica le componenti della data di immissione e l’ordine in cui si desidera visualizzarli, racchiuse tra parentesi e virgolette singole.

Questi sono i tipi di immissioni di componente singolo:

Tipo di immissione di componente singolo	Descrizione
'(W)'	Solo il componente del giorno della settimana (il formato originale deve avere solo il componente W).
'(M)'	Solo il componente mese (il formato originale deve avere solo il componente M).

Ci sono tipi di immissioni a due componenti:

Tipo di immissione a due componenti	Descrizione
'(YYM)'	Anno di quattro cifre seguito dal mese.
'(YM)'	Anno di due cifre seguito dal mese.
'(MYY)'	Componente mese seguita da anno di quattro cifre.
'(MY)'	Componente mese seguita da anno di due cifre.

Ci sono tipi di immissione a tre componenti:

Tipo di Immissione a Tre Componenti	Descrizione
'(YYMD)'	Anno di quattro cifre seguito dal mese seguito dal giorno.
'(YMD)'	Anno di due cifre seguito dal mese seguito dal giorno.
'(DMYY)'	Componente giorno seguita dal mese seguito dall’anno di quattro cifre.
'(DMY)'	Componente giorno seguita dal mese seguito dall’anno di due cifre.
'(MDYY)'	Componente mese seguita dal giorno seguito dall’anno di quattro cifre.
'(MDY)'	Componente mese seguita dal giorno seguito dall’anno di due cifre.
'(MD)'	Il componente mese è seguito dal giorno (derivato dalla data a tre componenti, ignorando il componente anno).
'(DM)'	Il componente giorno è seguito dal mese (derivato dalla data a tre componenti, ignorando il componente anno).

formatops

Stringa di zero o più opzioni di formattazione racchiusa tra parentesi e virgolette singole. Le parentesi e le virgolette sono obbligatorie anche se si specificano le opzioni di formattazione. La formattazione delle opzioni presentano le seguenti categorie:

• Opzioni per l'eliminazione degli zeri iniziali in numeri del mese o del giorno.

  Nota: L'eliminazione dello zero sostituisce gli zeri iniziali con spazi vuoti.

• Opzioni per la traduzione dei componenti mese o giorno, per caratteri maiuscoli completi o abbreviati o per i nomi con caratteri predefiniti (caratteri maiuscoli/minuscoli o minuscoli a seconda della lingua).
• Opzioni del delimitatore data e le opzioni per la punteggiatura di una data con virgole.

Le opzioni valide per l'eliminazione degli zeri iniziali nei numeri dei mesi o giorni sono elencati nella seguente tabella. Notare che lo zero iniziale viene sostituito da uno spazio vuoto:

Opzione Formato	Descrizione
m	Mesi con zero soppressi (visualizza numeri dei mesi che precedono Ottobre come da 1 a 9 anziché da 01 a 09).
d	Visualizza i giorni prima del dieci del mese, da 1 a 9, piuttosto che da 01 a 09.
dp	Visualizza giorni prima del dieci di ogni mese come 1 a 9, anziché 01 a 09, con un punto dopo il numero.
do	Visualizza i giorni prima del dieci del mese, da 1 a 9. Solo per l'inglese (langcode EN), visualizza un suffisso ordinale (st, nd, rd, or th) dopo il numero.

Le opzini di traduzione del nome giorno e mese validi sono:

Opzione Formato	Descrizione
T	Visualizza mese come nome abbreviato senza punteggiatura, tutto in maiuscole.
TR	Visualizza mese come nome completo, tutto in maiuscole.
Tp	Visualizza mese come nome abbreviato seguito da un punto, tutto in maiuscole.
t	Visualizza mese come nome abbreviato senza punteggiatura. Il nome è tutto in minuscole o con iniziale maiuscola, in base al codice lingua".
tr	Visualizza mese come nome completo. Il nome è tutto in minuscole o con iniziale maiuscola, in base al codice lingua".
tp	Visualizza mese come nome abbreviato seguito da un punto. Il nome si visualizza nei caratteri maiuscoli o minuscoli predefiniti della lingua specifica (per esempio, tutto in caratteri minuscoli per il francese e lo spagnolo e caratteri maiuscoli iniziali per l'inglese e ed il tedesco).
W	Include il nome abbreviato di un giorno della settimana all'inizio della data visualizzata, tutto in maiuscole, senza punteggiatura.
WR	Include il nome completo di un giorno della settimana all'inizio della data visualizzata, tutto in maiuscole.
Wp	Include il nome abbreviato di un giorno della settimana all'inizio della data visualizzata, tutto in maiuscole, seguito da un punto.
w	- Include il nome abbreviato di un giorno della settimana all'inizio della data visualizzata, senza punteggiatura". Il nome si visualizza nei caratteri maiuscoli o minuscoli predefiniti della lingua specificata (per esempio, tutti in caratteri minuscoli per il francese e lo spagnolo e caratteri maiuscoli iniziali per l'inglese e ed il tedesco).
wr	Include il nome completo di un giorno della settimana all'inizio della data visualizzata. Il nome si visualizza nei caratteri maiuscoli o minuscoli predefiniti della lingua specificata (per esempio, tutti in caratteri minuscoli per il francese e lo spagnolo e caratteri maiuscoli iniziali per l'inglese e ed il tedesco).
wp	- Include il nome abbreviato di un giorno della settimana all'inizio della data visualizzata, seguito da un punto". Il nome si visualizza nei caratteri maiuscoli o minuscoli predefiniti della lingua specificata (per esempio, tutti in caratteri minuscoli per il francese e lo spagnolo e caratteri maiuscoli iniziali per l'inglese e ed il tedesco).
X	Include il nome abbreviato di un giorno della settimana alla fine della data visualizzata, tutto in maiuscole senza punteggiatura.
XR	Include il nome completo di un giorno della settimana alla fine della data visualizzata, tutto in maiuscole.
Xp	Include il nome abbreviato di un giorno della settimana alla fine della data visualizzata, tutto in maiuscole, seguito da un punto.
x	- Include il nome abbreviato di un giorno della settimana alla fine della data visualizzata, senza punteggiatura". Il nome si visualizza nei caratteri maiuscoli o minuscoli predefiniti della lingua specificata (per esempio, tutti in caratteri minuscoli per il francese e lo spagnolo e caratteri maiuscoli iniziali per l'inglese e ed il tedesco).
xr	Include il nome completo di un giorno della settimana alla fine della data visualizzata. Il nome si visualizza nei caratteri maiuscoli o minuscoli predefiniti della lingua specificata (per esempio, tutti in caratteri minuscoli per il francese e lo spagnolo e caratteri maiuscoli iniziali per l'inglese e ed il tedesco).
xp	- Include il nome abbreviato di un giorno della settimana alla fine della data visualizzata, seguito da un punto". Il nome si visualizza nei caratteri maiuscoli o minuscoli predefiniti della lingua specificata (per esempio, tutti in caratteri minuscoli per il francese e lo spagnolo e caratteri maiuscoli iniziali per l'inglese e ed il tedesco).

Le opzioni del delimitatore data valide sono:

Opzione Formato	Descrizione
B	Utilizza uno spazio vuoto come delimitatore della componente. Questo è il valore predefinito se il mese o il giorno della settimana viene trasformato o se viene utilizzata una virgola.
.	Utilizza un punto come delimitatore della componente.
-	Utilizza uno spazio vuoto come delimitatore della componente. Si tratta dell'impostazione predefinita quando le condizioni per un delimitatore predefinito vuoto non sono soddisfacenti.
/	Utilizza una barra come delimitatore della componente.
|	Omette i delimitatori della componente.
K	Utilizza caratteri asiatici adeguati come delimitatori della componente.
c	Posiziona una virgola dopo il nome del mese (seguita da T, Tp, TR, t, tp, o tr). Posiziona una virgola e un spazio dopo il nome del giorno (seguiti da W, Wp, WR, w, wp, o wr). Posiziona una virgola e uno spazio prima del nome del giorno (seguita da X, XR, x, o xr).
e	Visualizza la parola spagnola o portoghese de o DE tra il giorno e il mese e tra il mese e l'anno. Il carattere della parola de è determinato dal carattere del nome del mese. Se il mese è visualizzato in caratteri maiuscoli, si visualizza DE, altrimenti si visualizza de. Utile per formati DMY, DMYY, MY e MYY.
D	Inserisce una virgola dopo il numero del giorno e prima del carattere di delimitazione generale specificato.
Y	Inserisce una virgola dopo l'anno e prima del carattere di delimitazione generale specificato.

lang

Codice ISO standard di due caratteri per la lingua nella quale la data deve essere trasformata, racchiusa tra virgolette singole. I codici di lingua validi sono:

'AR' arabo

'CS' ceco

'DA' danese

'DE' tedesco

'EN' inglese

'ES' spagnolo

'FI' finlandese

'FR' francese

'EL' greco

'IW' ebraico

'IT' italiano

'JA' giapponese

'KO' coreano

'LT' lituano

'NL' olandese

'NO' norvegese

'PO' polacco

'PT' portoghese

'RU' russo

'SV' svedese

'TH' tailandese

'TR' turco

'TW' cinese (tradizionale)

'ZH' cinese (semplificato)

outlen

Numerico

Lunghezza del campo di emissione in byte. Se la lunghezza non è sufficiente, è restituito un risultato con tutti gli spazi vuoti. Se la lunghezza è maggiore di quanto necessario, il campo è separato con spazi vuoti alla destra".

emissione

Alfanumerico

Nome del campo che contiene la data trasformata, o il rispettivo formato racchiuso tra virgolette singole.

x

• Il campo d'emissione, sebbene deve essere di tipo A e non AnV, potrebbe contenere le informazioni di lunghezza variabile, poiché le lughezze dei nomi mese e giorno possono variare e, inoltre, i numeri mese e giorno potrebbero essere lunghi uno o due byte, se si sceglie l'opzione di eliminazione zero. I byte inutilizzati si riempiono con spazi.
• Tutti le immissioni invalide e inconsistenti risultano in stringhe d'emissione vuote. Anche i dati mancanti risultano in emissioni vuote.
• Le date base (1900-12-31 and 1900-12 or 1901-01) sono trattate come se l'impostazione DATEDISPLAY fosse ON (ovvero, non visualizzate automaticamente come spazi). Per eliminare la stampa delle date base, che hanno un valore intero interno di 0, verificare lo 0 prima di chiamare DATETRAN. Per esempio:

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

• I componenti data validi tradotti sono contenuti in file chiamati DTLNG lng, dove lng è un codice a tre caratteri che specifica la lingua. Questi file devono essere accessibili per ciascuna lingua, di cui si desidera tradurre le date.
• Per far apparire questi caratteri NLS in modo corretto, il Server e il Client devono essere configurati con i page code corretti.
• La funzione DATETRAN non è supportata in Dialogue Manager.

Inizio pagina

Esempio: Uso della funzione DATETRAN

La seguente richiesta stampa il giorno della settimana nel caso predefinito del linguaggio specifico:

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

L'emissione è:

La seguente richiesta stampa una data delimitata da spazi con un nome mese abbreviato in inglese. Gli zeri iniziali nel numero del giorno sono eliminati e si aggiunge un suffisso alla fine del numero:

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 NOPRINT 
ON TABLE SET PAGE-NUM OFF
END

L'emissione è:

La seguente richiesta stampa una data delimitata da spazi con nu nome mese abbreviato in tedesco. Gli zeri iniziali nel numero del giorno vengono eliminati e si aggiunge un punto alla fine del numero:

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 NOPRINT 
ON TABLE SET PAGE-NUM OFF
END

L'emissione è:

Ls seguente richiesta stampa una data delimitata da spazi in francese con un nome giorno completo all'inizio e un nome mese completo, in caratteri minuscoli (l'impostazione predefinita per francese):

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 NOPRINT 
ON TABLE SET PAGE-NUM OFF
END

L'emissione è:

La seguente richiesta stampa una data delimitata da spazi in spagnolo con il nome completo di un giorno all’inizio in minuscolo (predefinito per lo spagnolo), seguito da una virgola e con la parola "de" tra il numero del giorno e il mese e tra il mese e l’anno:

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 NOPRINT 
ON TABLE SET PAGE-NUM OFF
END

L'emissione è:

La seguente richiesta stampa una data in caratteri giapponesi con un nome mese completo all'inizio, nei caratteri predefiniti, e con l'eliminazione degli zeri:

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 NOPRINT 
ON TABLE SET PAGE-NUM OFF
END

L'emissione è:

La seguente richiesta stampa una data delimitata da spazi in greco con un nome giorno completo all'inizio, nei caratteri predefiniti, seguita da una virgola, con un nome mese completo nei caratteri predefiniti:

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 NOPRINT 
ON TABLE SET PAGE-NUM OFF
END

L'emissione è: