Amministrazione di Oracle CRM On Demand > Expression Builder > Funzioni del Expression Builder > ToChar
ToChar
La funzione ToChar nel Expression Builder converte una data o un'espressione numerica specificata in una stringa formattata.
Sintassi
ToChar(espressione, formato)
ATTENZIONE: non utilizzare i formati della data e i formati numerici in un'istanza della funzione ToChar. Questa operazione può determinare risultati non validi.
Tipo di risultato
Stringa
Argomenti
Nella tabella seguente vengono descritti gli argomenti per questa funzione.
Argomento
|
Descrizione
|
espressione
|
Un'espressione o un campo che restituisce una data, una data e un'ora o un valore numerico.
|
formato
|
Una stringa che rappresenta il formato della data o numerico.
|
Nella tabella seguente vengono descritti i formati della data per la funzione.
Codice formato
|
Descrizione
|
DD
|
Il giorno del mese costituito da due cifre (01-31).
|
DDDD
dddd
|
Il nome del giorno.
|
MM
|
Un numero a due cifre (01-12 in cui 01 è GEN). È necessario utilizzare MM in maiuscolo, perché mm in minuscolo indica i minuti.
|
MMMM
mmmm
|
Il nome del mese. Tenere presente che se si utilizzano le lettere minuscole, è necessario utilizzare mmmm (ossia la lettera m in minuscolo ripetuta quattro volte), poiché mm (ossia, la lettera m in minuscolo ripetuta due volte) indica i minuti.
|
Y
|
L'ultima cifra dell'anno.
|
YY
|
Le ultime due cifre dell'anno.
|
YYYY
|
Un anno a quattro cifre.
|
hh12
|
L'ora del giorno nel formato di 12 ore.
|
hh24
|
L'ora del giorno nel formato di 24 ore.
|
hh
|
L'ora del giorno. È possibile specificare AM o PM per regolare l'ora di conseguenza, ad esempio:
hh:mm:ss PM
Se non si specifica AM o PM, per impostazione predefinita viene utilizzato il formato di 24 ore.
|
mm
|
I minuti. Tenere presente che mm (ossia la lettera m in minuscolo ripetuta due volte) indica sempre i minuti e non può essere utilizzata per specificare un giorno del mese costituito da due cifre.
|
ss
|
I secondi.
|
Nella tabella seguente vengono descritti i formati numerici per la funzione.
Codice formato
|
Esempio
|
Descrizione
|
#
|
####
|
Restituisce il valore con il numero specificato di cifre, con un segno meno iniziale se il valore è negativo.
|
0
|
####.00
|
Restituisce i valori iniziali e finali.
|
$
|
$###.00
|
Restituisce i valori con il simbolo del dollaro iniziale.
|
,
|
#,###
|
Restituisce una virgola nella posizione specificata. Non è possibile visualizzare una virgola a destra del separatore decimale. Il modello di formato non deve iniziare con una virgola.
|
.
|
###.##
|
Restituisce un separatore decimale nella posizione specificata. È consentito un solo separatore decimale nel parametro del formato. Se il numero di cifre specificato dopo il separatore decimale è minore del numero di cifre disponibili dopo il separatore decimale, il numero decimale viene arrotondato.
|
Esempi di uso di formati numerici
L'esempio seguente restituisce il valore 10.
ToChar (10, '##.##')
L'esempio seguente restituisce il valore 10.
ToChar (10, '##.00')
L'esempio seguente restituisce il valore 10.24.
ToChar (10.2388, '##.00')
L'esempio seguente restituisce il valore -10.24.
ToChar (-10.2388, '##.##')
Esempi di uso di formati data
L'esempio seguente converte il valore restituito dalla funzione Timestamp() nel formato DD/MM/YYYY:
ToChar(Timestamp(),'DD/MM/YYYY')
Ad esempio, se la funzione Timestamp() restituisce il valore 02/29/2008 10:58:37, l'espressione precedente restituirà 29/02/2008.
Gli esempi riportati di seguito mostrano come viene visualizzata la mezzanotte utilizzando vari formati:
ToChar(Today(), YYYY/MM/DD hh:mm:ss PM) restituisce 2009/05/22 12:00:00 AM
ToChar(Today(), YYYY/MM/DD hh:mm:ss) restituisce 2009/05/22 00:00:00
ToChar(Today(), YYYY/MM/DD hh:mm:ss) restituisce 2009/05/22 00:00:00:00
Argomenti correlati
Gli argomenti riportati di seguito contengono informazioni relative al Expression Builder.
|