Funzione ER DATETIMEFORMAT
La funzione DATETIMEFORMAT
restituisce un valore Stringa che presenta un valore specifico di data/ora come testo nel formato specificato e nelle impostazioni cultura specificate facoltativamente. Per informazioni sui formati supportati, vedere standard e personalizzato.
Sintassi 1
DATETIMEFORMAT (datetime, format)
Sintassi 2
DATETIMEFORMAT (datetime, format, culture)
Argomenti
datetime
: DateTime
Un valore di data/ora che rappresenta la data e l'ora da formattare.
format
: Stringa
Formato della stringa di output. Per informazioni sui formati supportati, vedere standard e personalizzato.
Nota
La stringa di formato fa distinzione tra maiuscole e minuscole quando si utilizza un formato standard o un formato personalizzato. Ad esempio, l'identificatore di formato "d" standard restituisce la data utilizzando il modello di data breve, mentre l'identificatore di formato "D" standard restituisce la data utilizzando il modello di data lunga. Inoltre, l'identificatore di formato "M" personalizzato restituisce il mese da 1 a 12, mentre l'identificatore di formato "m" personalizzato restituisce i minuti da 0 a 59.
culture
: Stringa
La cultura da utilizzare per la formattazione. Per informazioni sulle impostazioni cultura supportate, vedi impostazioni cultura.
Valori restituiti
String
Il valore di stringa risultante.
Note sull'utilizzo
Se la cultura non è definita come argomento della funzione richiamata, il valore di culture
è definito dal contesto di chiamata. Ad esempio, se la funzione DATETIMEFORMAT
viene richiamata utilizzando la sintassi 1 in un formato creazione di report elettronici (ER) per un elemento FILE che è configurato per utilizzare la cultura tedesca, la conversione verrà effettuata utilizzando la cultura tedesca. Il valore culture
predefinito è EN-US.
Quando la funzione DATETIMEFORMAT
converte un determinato valore data/ora, considera l'impostazione del fuso orario dell'utente dell'applicazione che esegue il formato ER da cui viene richiamata la funzione nel contesto.
Esempio 1
DATETIMEFORMAT (NOW(), "dd-MM-yyyy")
restituisce il valore data/ora del server di applicazioni, 24 dicembre 2015, come "24-12-2015", in base al formato personalizzato specificato.
Esempio 2
DATETIMEFORMAT (SESSIONNOW(), "d", "DE")
restituisce la data/ora della sessione dell'applicazione corrente, il 24 dicembre 2015, come "24.12.2015", basata sulla cultura tedesca selezionata e sul formato specificato.
Esempio 3
DATETIMEFORMAT (DATETIMEVALUE( "2019-11-12T09:00:00.0000000-07:00", "O"), "O")
restituisce il valore della stringa 2019-11-12T08:00:00.0000000-08:00 quando la funzione viene richiamata durante un processo avviato da un utente dell'applicazione che ha il valore del fuso orario (GMT-08: 00) Pacific Time (Stati Uniti e Canada) nella sezione Preferenze di lingua e paese.