Stringhe di formato di data e ora personalizzato
Una stringa di formato di data e ora definisce la rappresentazione testuale di un valore Date, DateTime, DateTimeZone o Time risultante da un'operazione di formattazione. Può anche definire la rappresentazione di un valore di data e ora richiesto in un'operazione di analisi per convertire correttamente la stringa in una data e ora. Una stringa di formato personalizzata è costituita da uno o più identificatori di formato di data e ora personalizzati. Qualsiasi stringa che non è una stringa di formato di data e ora standard viene interpretata come una stringa di formato di data e ora personalizzata.
Nelle operazioni di formattazione, le stringhe di formato di data e ora personalizzate possono essere usate con il metodo di un'istanza ToText di data e ora e fuso orario. Nell'esempio seguente vengono illustrati i relativi usi.
let
Source =
{
Text.From("Today is " & Date.ToText(#date(2011, 6, 10), [Format = "MMMM dd yyyy"]) & "."),
Text.Format("The current date and time: #{0}", {DateTimeZone.ToText(
#datetimezone(2011, 6, 10, 15, 24, 16, 0, 0), [Format = "MM/dd/yy H:mm:ss zzz"])}
)
}
in
Source
// The example displays the following output:
// Today is June 10, 2011.
// The current date and time: 06/10/11 15:24:16 +00:00
Nelle operazioni di analisi, le stringhe di formato di data e ora personalizzate possono essere usate con le funzioni Date, DateTime, Time e DateTimeZone . Queste funzioni richiedono che una stringa di input sia conforme esattamente a un modello specifico affinché l'operazione di analisi abbia esito positivo. Nell'esempio seguente viene illustrata una chiamata alla funzione DateTime.FromText per analizzare una data che deve includere un mese, un giorno e un anno a due cifre.
let
dateValues = { "30-12-2011", "12-30-2011", "30-12-11", "12-30-11"},
pattern = "MM-dd-yy",
convertedDates = List.Transform(dateValues, (dateValue) =>
try Text.Format("Converted '#{0}' to #{1}.", {dateValue, DateTime.FromText(dateValue, [Format=pattern])})
otherwise Text.Format("Unable to convert '#{0}' to a date and time.", {dateValue}))
in
convertedDates
// The example displays the following output:
// Unable to convert '30-12-2011' to a date and time.
// Unable to convert '12-30-2011' to a date and time.
// Unable to convert '30-12-11' to a date and time.
// Converted '12-30-11' to 12/30/2011.
Nella tabella seguente vengono descritti gli identificatori di formato di data e ora personalizzati e viene visualizzata una stringa di risultato prodotta da ogni identificatore di formato. Per impostazione predefinita, le stringhe di risultato riflettono le convenzioni di formattazione delle impostazioni cultura en-US. Se un identificatore di formato specifico produce una stringa di risultato localizzata, nell'esempio vengono anche indicate le impostazioni cultura alle quali si applica la stringa di risultato. Per altre informazioni sull'uso di stringhe di formato di data e ora personalizzate, vedere la sezione Note .
| Identificatore di formato | Descrizione | Esempi |
|---|---|---|
| "d" | Giorno del mese, da 1 a 31. Altre informazioni: identificatore di formato personalizzato "d". |
2009-06-01T13:45:30 -> 1 2009-06-15T13:45:30 -> 15 |
| "dd" | Giorno del mese, da 01 a 31. Altre informazioni: Identificatore di formato personalizzato "dd". |
2009-06-01T13:45:30 -> 01 2009-06-15T13:45:30 -> 15 |
| "ddd" | Nome abbreviato del giorno della settimana. Altre informazioni: identificatore di formato personalizzato "ddd". |
2009-06-15T13:45:30 -> Lun (en-US) 2009-06-15T13:45:30 -> Пн (ru-RU) 2009-06-15T13:45:30 -> lun. (fr-FR) |
| "dddd" | Nome completo del giorno della settimana. Altre informazioni: identificatore di formato personalizzato "dddd". |
2009-06-15T13:45:30 -> Lunedì (en-US) 2009-06-15T13:45:30 -> понедельник (ru-RU) 2009-06-15T13:45:30 -> lundi (fr-FR) |
| "f" | Decimi di secondo in un valore data e ora. Altre informazioni: identificatore di formato personalizzato "f". |
2009-06-15T13:45:30.6170000 -> 6 2009-06-15T13:45:30.05 -> 0 |
| "ff" | Centesimi di secondo in un valore data e ora. Altre informazioni: identificatore di formato personalizzato "ff". |
2009-06-15T13:45:30.6170000 -> 61 2009-06-15T13:45:30.0050000 -> 00 |
| "fff" | Millisecondi in un valore data e ora. Altre informazioni: identificatore di formato personalizzato "fff". |
15/6/2009 13:45:30.617 -> 617 15/6/2009 13:45:30.0005 -> 000 |
| "ffff" | Decimillesimi di secondo in un valore data e ora. Altre informazioni: Identificatore di formato personalizzato "ffff". |
2009-06-15T13:45:30.6175000 -> 6175 2009-06-15T13:45:30.0000500 -> 0000 |
| "fffff" | Centomillesimi di secondo in un valore data e ora. Altre informazioni: identificatore di formato personalizzato "fffff". |
2009-06-15T13:45:30.6175400 -> 61754 15/6/2009 13:45:30.000005 -> 00000 |
| "ffffff" | Milionesimi di secondo in un valore data e ora. Altre informazioni: Identificatore di formato personalizzato "ffffff". |
2009-06-15T13:45:30.6175420 -> 617542 2009-06-15T13:45:30.0000005 -> 0000000 |
| "fffffff" | Decine di milionesimi di secondo in un valore data e ora. Altre informazioni: identificatore di formato personalizzato "fffffff". |
2009-06-15T13:45:30.6175425 -> 6175425 2009-06-15T13:45:30.0001150 -> 0001150 |
| "F" | Se diverso da zero, decimi di secondo in un valore data e ora. Altre informazioni: Identificatore di formato personalizzato "F". |
2009-06-15T13:45:30.6170000 -> 6 2009-06-15T13:45:30.0500000 -> (nessun output) |
| "FF" | Se diverso da zero, centesimi di secondo in un valore data e ora. Altre informazioni: identificatore di formato personalizzato "FF". |
2009-06-15T13:45:30.6170000 -> 61 2009-06-15T13:45:30.0050000 -> (nessun output) |
| "FFF" | Se diverso da zero, millisecondi in un valore data e ora. Altre informazioni: identificatore di formato personalizzato "FFF". |
2009-06-15T13:45:30.6170000 -> 617 2009-06-15T13:45:30.0005000 -> (nessun output) |
| "FFFF" | Se diverso da zero, decimillesimi di secondo in un valore data e ora. Altre informazioni: Identificatore di formato personalizzato "FFFF". |
2009-06-15T13:45:30.5275000 -> 5275 2009-06-15T13:45:30.0000500 -> (nessun output) |
| "FFFFF" | Se diverso da zero, centomillesimi di secondo in un valore data e ora. Altre informazioni: identificatore di formato personalizzato "FFFFF". |
2009-06-15T13:45:30.6175400 -> 61754 2009-06-15T13:45:30.0000050 -> (nessun output) |
| "FFFFFF" | Se diverso da zero, milionesimi di secondo in un valore data e ora. Altre informazioni: identificatore di formato personalizzato "FFFFFF". |
2009-06-15T13:45:30.6175420 -> 617542 2009-06-15T13:45:30.0000005 -> (nessun output) |
| "FFFFFFF" | Se diverso da zero, decimilionesimi di secondo in un valore data e ora. Altre informazioni: identificatore di formato personalizzato "FFFFFFF". |
2009-06-15T13:45:30.6175425 -> 6175425 2009-06-15T13:45:30.0001150 -> 000115 |
| "g", "gg" | Periodo o era. Altre informazioni: identificatore di formato personalizzato "g" o "gg". |
2009-06-15T13:45:30.6170000 -> A.D. |
| "h" | Ora, usando un orario in formato 12 ore da 1 a 12. Altre informazioni: Identificatore di formato personalizzato "h". |
2009-06-15T01:45:30 -> 1 2009-06-15T13:45:30 -> 1 |
| "hh" | Ora, usando un orario in formato 12 ore da 01 a 12. Altre informazioni: Identificatore di formato personalizzato "hh". |
2009-06-15T01:45:30 -> 01 2009-06-15T13:45:30 -> 01 |
| "H" | Ora, usando un orario in formato 24 ore da 0 a 23. Altre informazioni: Identificatore di formato personalizzato "H". |
2009-06-15T01:45:30 -> 1 2009-06-15T13:45:30 -> 13 |
| "HH" | Ora, usando un orario in formato 24 ore da 00 a 23. Altre informazioni: Identificatore di formato personalizzato "HH". |
2009-06-15T01:45:30 -> 01 2009-06-15T13:45:30 -> 13 |
| "K" | Informazioni sul fuso orario. Altre informazioni: Identificatore di formato personalizzato "K". |
2009-06-15T13:45:30, Non specificato -> 2009-06-15T13:45:30, Utc -> +00:00 2009-06-15T13:45:30, Locale -> -07:00 (dipende dalle impostazioni del computer locale o cloud) |
| "m" | Il minuto, da 0 a 59. Altre informazioni: identificatore di formato personalizzato "m". |
2009-06-15T01:09:30 -> 9 2009-06-15T13:29:30 -> 29 |
| "mm" | Il minuto, da 00 a 59. Altre informazioni: Identificatore di formato personalizzato "mm". |
2009-06-15T01:09:30 -> 09 2009-06-15T01:45:30 -> 45 |
| "M" | Il mese, da 1 a 12. Altre informazioni: Identificatore di formato personalizzato "M". |
2009-06-15T13:45:30 -> 6 |
| "MM" | Il mese, da 01 a 12. Altre informazioni: Identificatore di formato personalizzato "MM". |
2009-06-15T13:45:30 -> 06 |
| "MMM" | Nome abbreviato del mese. Altre informazioni: Identificatore di formato personalizzato "MMM". |
2009-06-15T13:45:30 -> Jun (en-US) 2009-06-15T13:45:30 -> juin (fr-FR) 2009-06-15T13:45:30 -> Jun (zu-ZA) |
| "MMMM" | Nome completo del mese. Altre informazioni: Identificatore di formato personalizzato "MMMM". |
2009-06-15T13:45:30 -> Giugno (en-US) 2009-06-15T13:45:30 -> juni (da-DK) 2009-06-15T13:45:30 -> Juni (zu-ZA) |
| "s" | Secondo, da 0 a 59. Altre informazioni: identificatore di formato personalizzato "s". |
2009-06-15T13:45:09 -> 9 |
| "ss" | Il secondo, da 00 a 59. Altre informazioni: identificatore di formato personalizzato "ss". |
2009-06-15T13:45:09 -> 09 |
| "t" | Primo carattere dell'indicatore AM/PM. Altre informazioni: identificatore di formato personalizzato "t". |
2009-06-15T13:45:30 -> P (en-US) 2009-06-15T13:45:30 -> 午 (ja-JP) 2009-06-15T13:45:30 -> (fr-FR) |
| "tt" | Indicatore AM/PM. Altre informazioni: Identificatore di formato personalizzato "tt". |
2009-06-15T13:45:30 -> PM (en-US) 2009-06-15T13:45:30 -> 午後 (ja-JP) 2009-06-15T13:45:30 -> (fr-FR) |
| "y" | Anno, da 0 a 99. Altre informazioni: Identificatore di formato personalizzato "y". |
0001-01-01T00:00:00 -> 1 0900-01-01T00:00:00 -> 0 1900-01-01T00:00:00 -> 0 2009-06-15T13:45:30 -> 9 2019-06-15T13:45:30 -> 19 |
| "yy" | Anno, da 00 a 99. Altre informazioni: Identificatore di formato personalizzato "yy". |
0001-01-01T00:00:00 -> 01 0900-01-01T00:00:00 -> 00 1900-01-01T00:00:00 -> 00 2019-06-15T13:45:30 -> 19 |
| "yyy" | Anno, con un minimo di tre cifre. Altre informazioni: Identificatore di formato personalizzato "yyy". |
0001-01-01T00:00:00 -> 001 0900-01-01T00:00:00 -> 900 1900-01-01T00:00:00 -> 1900 2009-06-15T13:45:30 -> 2009 |
| "yyyy" | Anno, come numero a quattro cifre. Altre informazioni: identificatore di formato personalizzato "yyyy". |
0001-01-01T00:00:00 -> 0001 0900-01-01T00:00:00 -> 0900 1900-01-01T00:00:00 -> 1900 2009-06-15T13:45:30 -> 2009 |
| "yyyyy" | Anno, come numero a cinque cifre. Altre informazioni: identificatore di formato personalizzato "yyyyy". |
0001-01-01T00:00:00 -> 00001 2009-06-15T13:45:30 -> 02009 |
| "z" | Offset delle ore rispetto a UTC, senza zeri iniziali. Altre informazioni: Identificatore di formato personalizzato "z". |
2009-06-15T13:45:30-07:00 -> -7 |
| "zz" | Offset delle ore rispetto a UTC, con uno zero iniziale per un valore a una sola cifra. Altre informazioni: Identificatore di formato personalizzato "zz". |
2009-06-15T13:45:30-07:00 -> -07 |
| "zzz" | Offset di ore e minuti rispetto a UTC. Altre informazioni: identificatore di formato personalizzato "zzz". |
2009-06-15T13:45:30-07:00 -> -07:00 |
| ":" | Separatore dell'ora. Altre informazioni: Identificatore di formato personalizzato ":". |
2009-06-15T13:45:30 -> : (en-US) 2009-06-15T13:45:30 -> . (it-IT) 2009-06-15T13:45:30 -> : (ja-JP) |
| "/" | Separatore di data. Altre informazioni: identificatore di formato personalizzato "/". |
2009-06-15T13:45:30 -> / (en-US) 2009-06-15T13:45:30 -> - (ar-DZ) 2009-06-15T13:45:30 -> . (tr-TR) |
| "string" 'string' |
Delimitatore di stringa letterale. Altre informazioni: caratteri letterali. |
2009-06-15T13:45:30 (""arr:"" h:m t) -> arr: 1:45 P 2009-06-15T13:45:30 ('arr:' h:m t) -> arr: 1:45 P |
| % | Definisce il carattere seguente come identificatore di formato personalizzato. Altre informazioni: Uso di singoli identificatori di formato personalizzati. |
2009-06-15T13:45:30 (%h) -> 1 |
| \, "", ' | Sequenze di escape. Altre informazioni: Valori letterali carattere e Uso delle sequenze di escape. |
2009-06-15T13:45:30 (h \h) -> 1 h 2009-06-15T13:45:30 (h ""h"") -> 1 h 2009-06-15T13:45:30 (h') -> 1 h |
| Qualsiasi altro carattere | Il carattere viene copiato nella stringa di risultato senza alcuna modifica. Altre informazioni: caratteri letterali. |
2009-06-15T01:45:30 (arr hh:mm t) -> arr 01:45 A |
Nelle sezioni seguenti vengono fornite altre informazioni su ogni identificatore di formato data e ora personalizzato. Se non diversamente specificato, ogni identificatore produce una rappresentazione di stringa identica indipendentemente dal fatto che venga usato con un valore Date, DateTime, DateTimeZone o Time .
Identificatore di formato "d" giorno
Identificatore di formato personalizzato "d"
L'identificatore di formato personalizzato "d" rappresenta il giorno del mese come numero compreso tra 1 e 31. Un giorno a una sola cifra viene formattato senza uno zero iniziale.
Se l'identificatore di formato "d" viene usato senza altri identificatori di formato personalizzati, viene interpretato come l'identificatore di formato di data e ora standard "d". Per altre informazioni sull'uso di un singolo identificatore di formato, vedere Uso di identificatori di formato personalizzati singoli più avanti in questo articolo.
L'esempio seguente include l'identificatore di formato personalizzato "d" in diverse stringhe di formato.
let
Source =
{
DateTime.ToText(#datetime(2024, 8, 29, 19, 27, 15), [Format = "d, M", Culture = ""]),
// Displays 29, 8
DateTime.ToText(#datetime(2024, 8, 29, 19, 27, 15), [Format = "d, MMMM", Culture = "en-US"]),
// Displays 29, August
DateTime.ToText(#datetime(2024, 8, 29, 19, 27, 15), [Format = "d, MMMM", Culture = "es-MX"])
// Displays 29, agosto
}
in
Source
Identificatore di formato personalizzato "dd"
La stringa di formato personalizzato "dd" rappresenta il giorno del mese come numero compreso tra 01 e 31. Un giorno a una sola cifra viene formattato con uno zero iniziale.
L'esempio seguente include l'identificatore di formato personalizzato "dd" in una stringa di formato personalizzata.
let
Source =
{
DateTime.ToText(#datetime(2024, 1, 2, 6, 30, 15), [Format = "dd, MM", Culture = ""])
// Displays 02, 01
}
in
Source
Identificatore di formato personalizzato "ddd"
L'identificatore di formato personalizzato "ddd" rappresenta il nome abbreviato del giorno della settimana. Il nome abbreviato localizzato del giorno della settimana viene recuperato dalle impostazioni cultura correnti o specificate.
L'esempio seguente include l'identificatore di formato personalizzato "ddd" in una stringa di formato personalizzata.
let
Source =
{
DateTime.ToText(#datetime(2024, 8, 29, 19, 27, 15), [Format = "ddd d MMM", Culture = "en-US"]),
// Displays Thu 29 Aug
DateTime.ToText(#datetime(2024, 8, 29, 19, 27, 15), [Format = "ddd d MMM", Culture = "fr-FR"])
// Displays jeu. 29 août
}
in
Source
Identificatore di formato personalizzato "dddd"
L'identificatore di formato personalizzato "dddd" (più qualsiasi numero di identificatori "d" aggiuntivi) rappresenta il nome completo del giorno della settimana. Il nome localizzato del giorno della settimana viene recuperato dalle impostazioni cultura correnti o specificate.
L'esempio seguente include l'identificatore di formato personalizzato "dddd" in una stringa di formato personalizzata.
let
Source =
{
DateTime.ToText(#datetime(2024, 8, 29, 19, 27, 15), [Format = "dddd dd MMMM", Culture = "en-US"]),
// Displays Thursday 29 August
DateTime.ToText(#datetime(2024, 8, 29, 19, 27, 15), [Format = "dddd dd MMMM", Culture = "it-IT"])
// Displays giovedì 29 agosto
}
in
Source
Identificatore frazione "f" secondi minuscoli
Identificatore di formato personalizzato "f"
L'identificatore di formato personalizzato "f" rappresenta la cifra più significativa della frazione di secondi, ovvero i decimi di secondo in un valore di data e ora.
Se l'identificatore di formato "f" viene usato senza altri identificatori di formato, viene interpretato come l'identificatore di formato di data e ora standard "f". Per altre informazioni sull'uso di un singolo identificatore di formato, vedere Uso di identificatori di formato personalizzati singoli più avanti in questo articolo.
Quando si usano identificatori di formato "f" come parte di una stringa di formato fornita per analizzare il numero di secondi frazionari, il numero di identificatori di formato "f" indica il numero di cifre più significative della frazione di secondi che devono essere presenti per analizzare correttamente la stringa.
L'esempio seguente include l'identificatore di formato personalizzato "f" in una stringa di formato personalizzata.
let
Source =
{
DateTime.ToText(#datetime(2024, 8, 29, 19, 27, 15.018), [Format = "hh:mm:ss:f", Culture = ""]),
// Displays 07:27:15:0
DateTime.ToText(#datetime(2024, 8, 29, 19, 27, 15.018), [Format = "hh:mm:ss:F", Culture = ""])
// Displays 07:27:15:
}
in
Source
Identificatore di formato personalizzato "ff"
L'identificatore di formato personalizzato "ff" rappresenta le due cifre più significative della frazione di secondi, ovvero i centesimi di secondo in un valore di data e ora.
L'esempio seguente include l'identificatore di formato personalizzato "ff" in una stringa di formato personalizzata.
let
Source =
{
DateTime.ToText(#datetime(2024, 8, 29, 19, 27, 15.018), [Format = "hh:mm:ss:ff", Culture = ""]),
// Displays 07:27:15:01
DateTime.ToText(#datetime(2024, 8, 29, 19, 27, 15.018), [Format = "hh:mm:ss:FF", Culture = ""])
// Displays 07:27:15:01
}
in
Source
Identificatore di formato personalizzato "fff"
L'identificatore di formato personalizzato "fff" rappresenta le tre cifre più significative della frazione di secondi, ovvero i millisecondi in un valore di data e ora.
L'esempio seguente include l'identificatore di formato personalizzato "fff" in una stringa di formato personalizzata.
let
Source =
{
DateTime.ToText(#datetime(2024, 8, 29, 19, 27, 15.018), [Format = "hh:mm:ss:fff", Culture = ""]),
// Displays 07:27:15:018
DateTime.ToText(#datetime(2024, 8, 29, 19, 27, 15.018), [Format = "hh:mm:ss:FFF", Culture = ""])
// Displays 07:27:15:018
}
in
Source
Identificatore di formato personalizzato "ffff"
L'identificatore di formato personalizzato "ffff" rappresenta le quattro cifre più significative della frazione di secondi, ovvero i decimillesimi di secondo in un valore di data e ora.
Sebbene sia possibile visualizzare i dieci millesimi di un secondo componente di un valore temporale, tale valore potrebbe non essere significativo. La precisione dei valori di data e ora dipende dalla risoluzione del clock di sistema. Nei sistemi operativi Windows Server 2019 e Windows 11 la risoluzione dell'orologio è di circa 1 millisecondo.
Identificatore di formato personalizzato "fffff"
L'identificatore di formato personalizzato "fffff" rappresenta le cinque cifre più significative della frazione di secondi, ovvero i centomillesimi di secondo in un valore di data e ora.
Anche se è possibile visualizzare i centesimi di millesimi di un secondo componente di un valore temporale, tale valore potrebbe non essere significativo. La precisione dei valori di data e ora dipende dalla risoluzione del clock di sistema. Nei sistemi operativi Windows Server 2019 e Windows 11 la risoluzione dell'orologio è di circa 1 millisecondo.
Identificatore di formato personalizzato "ffffff"
L'identificatore di formato personalizzato "ffffff" rappresenta le sei cifre più significative della frazione di secondi, ovvero i milionesimi di secondo in un valore di data e ora.
Anche se è possibile visualizzare i milionesimi di un secondo componente di un valore temporale, tale valore potrebbe non essere significativo. La precisione dei valori di data e ora dipende dalla risoluzione del clock di sistema. Nei sistemi operativi Windows Server 2019 e Windows 11 la risoluzione dell'orologio è di circa 1 millisecondo.
Identificatore di formato personalizzato "fffffff"
L'identificatore di formato personalizzato "fffffff" rappresenta le sette cifre più significative della frazione di secondi, ovvero i decimilionesimi di secondo in un valore di data e ora.
Anche se è possibile visualizzare i dieci milioni di secondi di un secondo componente di un valore temporale, tale valore potrebbe non essere significativo. La precisione dei valori di data e ora dipende dalla risoluzione del clock di sistema. Nei sistemi operativi Windows Server 2019 e Windows 11 la risoluzione dell'orologio è di circa 1 millisecondo.
Identificatore frazione "F" secondi maiuscoli
Identificatore di formato personalizzato "F"
L'identificatore di formato personalizzato "F" rappresenta la cifra più significativa della frazione di secondi, ovvero i decimi di secondo in un valore di data e ora. Non viene visualizzato alcun valore se la cifra è zero e anche il separatore decimale che segue il numero di secondi non viene visualizzato.
Se l'identificatore di formato "F" viene usato senza altri identificatori di formato, viene interpretato come l'identificatore di formato di data e ora standard "F". Per altre informazioni sull'uso di un singolo identificatore di formato, vedere Uso di identificatori di formato personalizzati singoli più avanti in questo articolo.
Il numero di identificatori di formato "F" utilizzati durante l'analisi indica il numero massimo di cifre più significative della frazione di secondi che possono essere presenti per analizzare correttamente la stringa.
L'esempio seguente include l'identificatore di formato personalizzato "F" in una stringa di formato personalizzata.
let
Source =
{
DateTime.ToText(#datetime(2024, 8, 29, 19, 27, 15.018), [Format = "hh:mm:ss:f", Culture = ""]),
// Displays 07:27:15:0
DateTime.ToText(#datetime(2024, 8, 29, 19, 27, 15.018), [Format = "hh:mm:ss:F", Culture = ""])
// Displays 07:27:15:
}
in
Source
Identificatore di formato personalizzato "FF"
L'identificatore di formato personalizzato "FF" rappresenta le due cifre più significative della frazione di secondi, ovvero i centesimi di secondo in un valore di data e ora. Gli zeri finali non vengono visualizzati. Non viene visualizzato alcun valore se le due cifre significative sono zero e, in tal caso, anche il separatore decimale che segue il numero di secondi non viene visualizzato.
L'esempio seguente include l'identificatore di formato personalizzato "FF" in una stringa di formato personalizzata.
let
Source =
{
DateTime.ToText(#datetime(2024, 8, 29, 19, 27, 15.018), [Format = "hh:mm:ss:ff", Culture = ""]),
// Displays 07:27:15:01
DateTime.ToText(#datetime(2024, 8, 29, 19, 27, 15.018), [Format = "hh:mm:ss:FF", Culture = ""])
// Displays 07:27:15:01
}
in
Source
Identificatore di formato personalizzato "FFF"
L'identificatore di formato personalizzato "FFF" rappresenta le tre cifre più significative della frazione di secondi, ovvero i millisecondi in un valore di data e ora. Gli zeri finali non vengono visualizzati. Non viene visualizzato alcun valore se le tre cifre significative sono zero e, in tal caso, anche il separatore decimale che segue il numero di secondi non viene visualizzato.
L'esempio seguente include l'identificatore di formato personalizzato "FFF" in una stringa di formato personalizzata.
let
Source =
{
DateTime.ToText(#datetime(2024, 8, 29, 19, 27, 15.018), [Format = "hh:mm:ss:fff", Culture = ""]),
// Displays 07:27:15:018
DateTime.ToText(#datetime(2024, 8, 29, 19, 27, 15.018), [Format = "hh:mm:ss:FFF", Culture = ""])
// Displays 07:27:15:018
}
in
Source
Identificatore di formato personalizzato "FFFF"
L'identificatore di formato personalizzato "FFFF" rappresenta le quattro cifre più significative della frazione di secondi, ovvero i decimillesimi di secondo in un valore di data e ora. Gli zeri finali non vengono visualizzati. Non viene visualizzato alcun valore se le quattro cifre significative sono zero e, in tal caso, anche il separatore decimale che segue il numero di secondi non viene visualizzato.
Sebbene sia possibile visualizzare i dieci millesimi di un secondo componente di un valore temporale, tale valore potrebbe non essere significativo. La precisione dei valori di data e ora dipende dalla risoluzione del clock di sistema. Nei sistemi operativi Windows Server 2019 e Windows 11 la risoluzione dell'orologio è di circa 1 millisecondo.
Identificatore di formato personalizzato "FFFFF"
L'identificatore di formato personalizzato "FFFFF" rappresenta le cinque cifre più significative della frazione di secondi, ovvero i centomillesimi di secondo in un valore di data e ora. Gli zeri finali non vengono visualizzati. Non viene visualizzato alcun valore se le cinque cifre significative sono zero e, in tal caso, anche il separatore decimale che segue il numero di secondi non viene visualizzato.
Anche se è possibile visualizzare i centesimi di millesimi di un secondo componente di un valore temporale, tale valore potrebbe non essere significativo. La precisione dei valori di data e ora dipende dalla risoluzione del clock di sistema. Nei sistemi operativi Windows Server 2019 e Windows 11 la risoluzione dell'orologio è di circa 1 millisecondo.
Identificatore di formato personalizzato "FFFFFF"
L'identificatore di formato personalizzato "FFFFFF" rappresenta le sei cifre più significative della frazione di secondi, ovvero i milionesimi di secondo in un valore di data e ora. Gli zeri finali non vengono visualizzati. Non viene visualizzato alcun valore se le sei cifre significative sono zero e, in tal caso, anche il separatore decimale che segue il numero di secondi non viene visualizzato.
Anche se è possibile visualizzare i milionesimi di un secondo componente di un valore temporale, tale valore potrebbe non essere significativo. La precisione dei valori di data e ora dipende dalla risoluzione del clock di sistema. Nei sistemi operativi Windows Server 2019 e Windows 11 la risoluzione dell'orologio è di circa 1 millisecondo.
Identificatore di formato personalizzato "FFFFFFF"
L'identificatore di formato personalizzato "FFFFFFF" rappresenta le sette cifre più significative della frazione di secondi, ovvero i decimilionesimi di secondo in un valore di data e ora. Gli zeri finali non vengono visualizzati. Non viene visualizzato alcun valore se le sette cifre significative sono zero e, in tal caso, anche il separatore decimale che segue il numero di secondi non viene visualizzato.
Anche se è possibile visualizzare i dieci milioni di secondi di un secondo componente di un valore temporale, tale valore potrebbe non essere significativo. La precisione dei valori di data e ora dipende dalla risoluzione del clock di sistema. Nei sistemi operativi Windows Server 2019 e Windows 11 la risoluzione dell'orologio è di circa 1 millisecondo.
Identificatore di formato "g" era
Identificatore di formato personalizzato "g" o "gg"
Gli identificatori di formato personalizzati "g" o "gg" (più qualsiasi numero di identificatori "g" aggiuntivi) rappresentano il punto o l'era, ad esempio A.D. L'operazione di formattazione ignora questo identificatore se la data da formattare non ha una stringa di periodo o di era associata.
Se l'identificatore di formato "g" viene usato senza altri identificatori di formato personalizzati, viene interpretato come l'identificatore di formato di data e ora standard "g". Per altre informazioni sull'uso di un singolo identificatore di formato, vedere Uso di identificatori di formato personalizzati singoli più avanti in questo articolo.
L'esempio seguente include l'identificatore di formato personalizzato "g" in una stringa di formato personalizzata.
let
Source =
{
Date.ToText(#date(70, 08, 04), [Format = "MM/dd/yyyy g", Culture = ""]),
// Displays 08/04/0070 A.D.
Date.ToText(#date(70, 08, 04), [Format = "MM/dd/yyyy g", Culture = "fr-FR"])
// Displays 08/04/0070 ap. J.-C.
}
in
Source
Identificatore di formato "h" ora minuscola
Identificatore di formato personalizzato "h"
L'identificatore di formato personalizzato "h" rappresenta l'ora come numero compreso tra 1 e 12; ovvero, l'ora è rappresentata da un orologio di 12 ore che conta le ore intere dalla mezzanotte o mezzogiorno. Una particolare ora dopo mezzanotte non è distinguibile dalla stessa ora dopo mezzogiorno. L'ora non viene arrotondata e un'ora a cifra singola viene formattata senza zero iniziale. Se viene, ad esempio, specificata un'ora equivalente alle 5:43 della mattina o del pomeriggio, tramite questo identificatore di formato personalizzato viene visualizzato "5".
Se l'identificatore di formato "h" viene usato senza altri identificatori di formato personalizzati, viene interpretato come identificatore di formato di data e ora standard e genera un errore di espressione. Per altre informazioni sull'uso di un singolo identificatore di formato, vedere Uso di identificatori di formato personalizzati singoli più avanti in questo articolo.
L'esempio seguente include l'identificatore di formato personalizzato "h" in una stringa di formato personalizzata.
let
Source =
{
DateTime.ToText(#datetime(2024, 1, 1, 18, 9, 1), [Format = "h:m:s.F t", Culture = ""]),
// Displays 6:9:1 P
DateTime.ToText(#datetime(2024, 1, 1, 18, 9, 1), [Format = "h:m:s.F t", Culture = "el-GR"]),
// Displays 6:9:1 μ
DateTime.ToText(#datetime(2024, 1, 1, 9, 18, 1.500), [Format = "h:m:s.F t", Culture = ""]),
// Displays 9:18:1.5 A
DateTime.ToText(#datetime(2024, 1, 1, 9, 18, 1.500), [Format = "h:m:s.F t", Culture = "el-GR"])
// Displays 9:18:1.5 π
}
in
Source
Identificatore di formato personalizzato "hh"
L'identificatore di formato personalizzato "hh" (più qualsiasi numero di identificatori "h" aggiuntivi) rappresenta l'ora come numero compreso tra 01 e 12; ovvero, l'ora è rappresentata da un orologio di 12 ore che conta le ore intere dalla mezzanotte o mezzogiorno. Una particolare ora dopo mezzanotte non è distinguibile dalla stessa ora dopo mezzogiorno. L'ora non viene arrotondata e un'ora a una cifra viene formattata con uno zero iniziale. Se viene, ad esempio, specificata un'ora equivalente alle 5:43 della mattina o del pomeriggio, tramite questo identificatore di formato viene visualizzato "05".
L'esempio seguente include l'identificatore di formato personalizzato "hh" in una stringa di formato personalizzata.
let
Source =
{
DateTime.ToText(#datetime(2024, 1, 1, 18, 9, 1), [Format = "hh:mm:ss tt", Culture = ""]),
// Displays 06:09:01 PM
DateTime.ToText(#datetime(2024, 1, 1, 18, 9, 1), [Format = "hh:mm:ss tt", Culture = "hu-HU"]),
// Displays 06:09:01 du.
DateTime.ToText(#datetime(2024, 1, 1, 9, 18, 1.500), [Format = "hh:mm:ss.ff tt", Culture = ""]),
// Displays 09:18:01.50 AM
DateTime.ToText(#datetime(2024, 1, 1, 9, 18, 1.500), [Format = "hh:mm:ss.ff tt", Culture = "hu-HU"])
// Displays 09:18:01.50 de.
}
in
Source
Identificatore di formato "H" ora maiuscola
Identificatore di formato personalizzato "H"
L'identificatore di formato personalizzato "H" rappresenta l'ora come numero compreso tra 0 e 23; ovvero, l'ora è rappresentata da un orologio a 24 ore in base zero che conta le ore dalla mezzanotte. Un'ora costituita da una singola cifra viene formattata senza zero iniziale.
Se l'identificatore di formato "H" viene usato senza altri identificatori di formato personalizzati, viene interpretato come identificatore di formato di data e ora standard e genera un errore di espressione. Per altre informazioni sull'uso di un singolo identificatore di formato, vedere Uso di identificatori di formato personalizzati singoli più avanti in questo articolo.
L'esempio seguente include l'identificatore di formato personalizzato "H" in una stringa di formato personalizzata.
let
Source =
{
DateTime.ToText(#datetime(2024, 1, 1, 6, 9, 1), [Format = "H:mm:ss", Culture = ""])
// Displays 6:09:01
}
in
Source
Identificatore di formato personalizzato "HH"
L'identificatore di formato personalizzato "HH" (più qualsiasi numero di identificatori "H" aggiuntivi) rappresenta l'ora come numero compreso tra 00 e 23; ovvero, l'ora è rappresentata da un orologio a 24 ore in base zero che conta le ore dalla mezzanotte. Un'ora costituita da una singola cifra viene formattata con uno zero iniziale.
L'esempio seguente include l'identificatore di formato personalizzato "HH" in una stringa di formato personalizzata.
let
Source =
{
DateTime.ToText(#datetime(2024, 1, 1, 6, 9, 1), [Format = "HH:mm:ss", Culture = ""])
// Displays 06:09:01
}
in
Source
Identificatore di formato "K" del fuso orario
Identificatore di formato personalizzato "K"
L'identificatore di formato personalizzato "K" rappresenta le informazioni sul fuso orario di un valore di data e ora. Quando questo identificatore di formato viene usato con i valori DateTimeZone , la stringa di risultato viene definita come:
Per il fuso orario locale, questo identificatore genera una stringa di risultato contenente l'offset locale dall'ora UTC (Coordinated Universal Time), ad esempio "-07:00", se la query viene eseguita in Power Query Desktop. Se la query viene eseguita in Power Query Online, la stringa di risultato non produce alcun offset dall'ora UTC, ovvero "+00:00".
Per un'ora UTC, la stringa di risultato non produce offset dall'ora UTC; ovvero "+00:00 per rappresentare una data UTC.
Per un'ora da un fuso orario non specificato, il risultato è vuoto.
Se l'identificatore di formato "K" viene usato senza altri identificatori di formato personalizzati, viene interpretato come identificatore di formato di data e ora standard e genera un errore di espressione. Per altre informazioni sull'uso di un singolo identificatore di formato, vedere Uso di identificatori di formato personalizzati singoli più avanti in questo articolo.
Nell'esempio seguente viene visualizzata la stringa risultante dall'uso dell'identificatore di formato personalizzato "K" con vari valori in un sistema nel fuso orario pacifico degli Stati Uniti.
let
Source =
{
DateTimeZone.ToText(DateTimeZone.LocalNow(),[Format="%K"]),
// Displays -07:00 (Desktop) or +00:00 (Online)
DateTimeZone.ToText(DateTimeZone.UtcNow(),[Format="%K"]),
// Displays +00:00
Text.Format("'#{0}'", {DateTime.ToText(DateTime.LocalNow(),[Format="%K"])})
// Displays ''
}
in
Source
Nota
Il valore restituito da DateTimeZone.LocalNow dipende dal fatto che si esegua Power Query in un computer locale o online. Ad esempio, nell'esempio precedente in un sistema nel fuso orario pacifico degli Stati Uniti, Power Query Desktop restituisce -07:00 perché legge l'ora impostata nel computer locale. Tuttavia, Power Query Online restituisce +00:00 perché legge l'ora impostata nelle macchine virtuali cloud, impostate su UTC.
Identificatore di formato "m" minuto
Identificatore di formato personalizzato "m"
L'identificatore di formato personalizzato "m" rappresenta il minuto come numero compreso tra 0 e 59. Tali minuti rappresentano il numero intero di minuti passati dall'ultima ora. Un minuto costituito da una singola cifra viene formattato senza zero iniziale.
Se l'identificatore di formato "m" viene usato senza altri identificatori di formato personalizzati, viene interpretato come l'identificatore di formato di data e ora standard "m". Per altre informazioni sull'uso di un singolo identificatore di formato, vedere Uso di identificatori di formato personalizzati singoli più avanti in questo articolo.
L'esempio seguente include l'identificatore di formato personalizzato "m" in una stringa di formato personalizzata.
let
Source =
{
DateTime.ToText(#datetime(2024, 1, 1, 18, 9, 1), [Format = "h:m:s.F t", Culture = ""]),
// Displays 6:9:1 P
DateTime.ToText(#datetime(2024, 1, 1, 18, 9, 1), [Format = "h:m:s.F t", Culture = "el-GR"]),
// Displays 6:9:1 μ
DateTime.ToText(#datetime(2024, 1, 1, 9, 18, 1.500), [Format = "h:m:s.F t", Culture = ""]),
// Displays 9:18:1.5 A
DateTime.ToText(#datetime(2024, 1, 1, 9, 18, 1.500), [Format = "h:m:s.F t", Culture = "el-GR"])
// Displays 9:18:1.5 π
}
in
Source
Identificatore di formato personalizzato "mm"
L'identificatore di formato personalizzato "mm" (più qualsiasi numero di identificatori "m" aggiuntivi) rappresenta il minuto come numero compreso tra 00 e 59. Tali minuti rappresentano il numero intero di minuti passati dall'ultima ora. Un minuto costituito da una singola cifra viene formattato con uno zero iniziale.
L'esempio seguente include l'identificatore di formato personalizzato "mm" in una stringa di formato personalizzata.
let
Source =
{
DateTime.ToText(#datetime(2024, 1, 1, 18, 9, 1), [Format = "hh:mm:ss tt", Culture = ""]),
// Displays 06:09:01 PM
DateTime.ToText(#datetime(2024, 1, 1, 18, 9, 1), [Format = "hh:mm:ss tt", Culture = "hu-HU"]),
// Displays 06:09:01 du.
DateTime.ToText(#datetime(2024, 1, 1, 9, 18, 1.500), [Format = "hh:mm:ss.ff tt", Culture = ""]),
// Displays 09:18:01.50 AM
DateTime.ToText(#datetime(2024, 1, 1, 9, 18, 1.500), [Format = "hh:mm:ss.ff tt", Culture = "hu-HU"])
// Displays 09:18:01.50 de.
}
in
Source
Identificatore di formato "M" del mese
Identificatore di formato personalizzato "M"
L'identificatore di formato personalizzato "M" rappresenta il mese come numero compreso tra 1 e 12 (o da 1 a 13 per i calendari con 13 mesi). Un mese a una sola cifra viene formattato senza uno zero iniziale.
Se l'identificatore di formato "M" viene usato senza altri identificatori di formato personalizzati, viene interpretato come l'identificatore di formato di data e ora standard "M". Per altre informazioni sull'uso di un singolo identificatore di formato, vedere Uso di identificatori di formato personalizzati singoli più avanti in questo articolo.
L'esempio seguente include l'identificatore di formato personalizzato "M" in una stringa di formato personalizzata.
let
Source =
{
Date.ToText(#date(2024, 8, 18), [Format = "(M) MMM, MMMM", Culture = "en-US"]),
// Displays (8) Aug, August
Date.ToText(#date(2024, 8, 18), [Format = "(M) MMM, MMMM", Culture = "nl-NL"]),
// Displays (8) aug, augustus
Date.ToText(#date(2024, 8, 18), [Format = "(M) MMM, MMMM", Culture = "lv-LV"])
// Displays (8) aug., augusts
}
in
Source
Identificatore di formato personalizzato "MM"
L'identificatore di formato personalizzato "MM" rappresenta il mese come numero compreso tra 01 e 12 (o da 1 a 13 per i calendari con 13 mesi). Un mese a una sola cifra viene formattato con uno zero iniziale.
L'esempio seguente include l'identificatore di formato personalizzato "MM" in una stringa di formato personalizzata.
let
Source =
{
DateTime.ToText(#datetime(2024, 1, 2, 6, 30, 15), [Format = "dd, MM", Culture = ""])
// Displays 02, 01
}
in
Source
Identificatore di formato personalizzato "MMM"
L'identificatore di formato personalizzato "MMM" rappresenta il nome abbreviato del mese. Il nome abbreviato localizzato del mese viene recuperato dai nomi abbreviati dei mesi correnti o specificati. Se nella stringa di formato personalizzato è presente un identificatore di formato personalizzato "d" o "dd", il nome del mese viene recuperato dai nomi genitivi abbreviati.
L'esempio seguente include l'identificatore di formato personalizzato "MMM" in una stringa di formato personalizzata.
let
Source =
{
DateTime.ToText(#datetime(2024, 8, 29, 19, 27, 15), [Format = "ddd d MMM", Culture = "en-US"]),
// Displays Thu 29 Aug
DateTime.ToText(#datetime(2024, 8, 29, 19, 27, 15), [Format = "ddd d MMM", Culture = "fr-FR"])
// Displays jeu. 29 août
}
in
Source
Identificatore di formato personalizzato "MMMM"
L'identificatore di formato personalizzato "MMMM" rappresenta il nome completo del mese. Il nome localizzato del mese viene recuperato dalle impostazioni cultura correnti o specificate. Se nella stringa di formato personalizzato è presente un identificatore di formato personalizzato "d" o "dd", il nome del mese viene recuperato dai nomi genitivi abbreviati.
L'esempio seguente include l'identificatore di formato personalizzato "MMMM" in una stringa di formato personalizzata.
let
Source =
{
DateTime.ToText(#datetime(2024, 8, 29, 19, 27, 15), [Format = "dddd dd MMMM", Culture = "en-US"]),
// Displays Thursday 29 August
DateTime.ToText(#datetime(2024, 8, 29, 19, 27, 15), [Format = "dddd dd MMMM", Culture = "it-IT"])
// Displays giovedì 29 agosto
}
in
Source
Identificatore di formato "s" secondi
Identificatore di formato personalizzato "s"
L'identificatore di formato personalizzato "s" rappresenta i secondi come numero compreso tra 0 e 59. Il risultato rappresenta il numero intero di secondi passati dall'ultimo minuto. Un secondo costituito da una singola cifra viene formattato senza zero iniziale.
Se l'identificatore di formato "s" viene usato senza altri identificatori di formato personalizzati, viene interpretato come l'identificatore di formato di data e ora standard "s". Per altre informazioni sull'uso di un singolo identificatore di formato, vedere Uso di identificatori di formato personalizzati singoli più avanti in questo articolo.
L'esempio seguente include l'identificatore di formato personalizzato "s" in una stringa di formato personalizzata.
let
Source =
{
DateTime.ToText(#datetime(2024, 1, 1, 18, 9, 1), [Format = "h:m:s.F t", Culture = ""]),
// Displays 6:9:1 P
DateTime.ToText(#datetime(2024, 1, 1, 18, 9, 1), [Format = "h:m:s.F t", Culture = "el-GR"]),
// Displays 6:9:1 μ
DateTime.ToText(#datetime(2024, 1, 1, 9, 18, 1.500), [Format = "h:m:s.F t", Culture = ""]),
// Displays 9:18:1.5 A
DateTime.ToText(#datetime(2024, 1, 1, 9, 18, 1.500), [Format = "h:m:s.F t", Culture = "el-GR"])
// Displays 9:18:1.5 π
}
in
Source
Identificatore di formato personalizzato "ss"
L'identificatore di formato personalizzato "ss" (più qualsiasi numero di identificatori "s" aggiuntivi) rappresenta i secondi come numero compreso tra 00 e 59. Il risultato rappresenta il numero intero di secondi passati dall'ultimo minuto. Un secondo costituito da una singola cifra viene formattato con uno zero iniziale.
L'esempio seguente include l'identificatore di formato personalizzato "ss" in una stringa di formato personalizzata.
let
Source =
{
DateTime.ToText(#datetime(2024, 1, 1, 18, 9, 1), [Format = "hh:mm:ss tt", Culture = ""]),
// Displays 06:09:01 PM
DateTime.ToText(#datetime(2024, 1, 1, 18, 9, 1), [Format = "hh:mm:ss tt", Culture = "hu-HU"]),
// Displays 06:09:01 du.
DateTime.ToText(#datetime(2024, 1, 1, 9, 18, 1.500), [Format = "hh:mm:ss.ff tt", Culture = ""]),
// Displays 09:18:01.50 AM
DateTime.ToText(#datetime(2024, 1, 1, 9, 18, 1.500), [Format = "hh:mm:ss.ff tt", Culture = "hu-HU"])
// Displays 09:18:01.50 de.
}
in
Source
Identificatore di formato Meridiem "t"
Identificatore di formato personalizzato "t"
L'identificatore di formato personalizzato "t" rappresenta il primo carattere dell'indicatore AM/PM. Il designatore localizzato appropriato viene recuperato dalle impostazioni cultura correnti o specifiche. L'indicatore AM viene usato per tutti gli orari da 0:00:00 (mezzanotte) a 11:59:59.999. L'indicatore PM viene usato per tutti gli orari da 12:00:00 (mezzogiorno) a 23:59:59.999.
Se l'identificatore di formato "t" viene usato senza altri identificatori di formato personalizzati, viene interpretato come l'identificatore di formato data e ora standard "t". Per altre informazioni sull'uso di un singolo identificatore di formato, vedere Uso di identificatori di formato personalizzati singoli più avanti in questo articolo.
L'esempio seguente include l'identificatore di formato personalizzato "t" in una stringa di formato personalizzata.
let
Source =
{
DateTime.ToText(#datetime(2024, 1, 1, 18, 9, 1), [Format = "h:m:s.F t", Culture = ""]),
// Displays 6:9:1 P
DateTime.ToText(#datetime(2024, 1, 1, 18, 9, 1), [Format = "h:m:s.F t", Culture = "el-GR"]),
// Displays 6:9:1 μ
DateTime.ToText(#datetime(2024, 1, 1, 9, 18, 1.500), [Format = "h:m:s.F t", Culture = ""]),
// Displays 9:18:1.5 A
DateTime.ToText(#datetime(2024, 1, 1, 9, 18, 1.500), [Format = "h:m:s.F t", Culture = "el-GR"])
// Displays 9:18:1.5 π
}
in
Source
Identificatore di formato personalizzato "tt"
L'identificatore di formato personalizzato "tt" (più qualsiasi numero di identificatori "t" aggiuntivi) rappresenta l'indicatore AM/PM completo. Il designatore localizzato appropriato viene recuperato dalle impostazioni cultura correnti o specifiche. L'indicatore AM viene usato per tutti gli orari da 0:00:00 (mezzanotte) a 11:59:59.999. L'indicatore PM viene usato per tutti gli orari da 12:00:00 (mezzogiorno) a 23:59:59.999.
Assicurarsi di usare l'identificatore "tt" per le lingue per le quali è necessario mantenere la distinzione tra AM e PM. Un esempio è la lingua giapponese per cui gli indicatori AM e PM differiscono in corrispondenza del secondo carattere anziché del primo.
L'esempio seguente include l'identificatore di formato personalizzato "tt" in una stringa di formato personalizzata.
let
Source =
{
DateTime.ToText(#datetime(2024, 1, 1, 18, 9, 1), [Format = "hh:mm:ss tt", Culture = ""]),
// Displays 06:09:01 PM
DateTime.ToText(#datetime(2024, 1, 1, 18, 9, 1), [Format = "hh:mm:ss tt", Culture = "hu-HU"]),
// Displays 06:09:01 du.
DateTime.ToText(#datetime(2024, 1, 1, 9, 18, 1.500), [Format = "hh:mm:ss.ff tt", Culture = ""]),
// Displays 09:18:01.50 AM
DateTime.ToText(#datetime(2024, 1, 1, 9, 18, 1.500), [Format = "hh:mm:ss.ff tt", Culture = "hu-HU"])
// Displays 09:18:01.50 de.
}
in
Source
Identificatore di formato "y" anno
Identificatore di formato personalizzato "y"
L'identificatore di formato personalizzato "y" rappresenta l'anno come numero a una cifra o a due cifre. Se l'anno ha più di due cifre, nel risultato vengono visualizzate solo le due cifre di ordine inferiore. Se la prima cifra di un anno a due cifre inizia con zero (ad esempio, 2008), il numero viene formattato senza zero iniziale.
Se l'identificatore di formato "y" viene usato senza altri identificatori di formato personalizzati, viene interpretato come l'identificatore di formato di data e ora standard "y". Per altre informazioni sull'uso di un singolo identificatore di formato, vedere Uso di identificatori di formato personalizzati singoli più avanti in questo articolo.
L'esempio seguente include l'identificatore di formato personalizzato "y" in una stringa di formato personalizzata.
let
Source =
{
Date.ToText(#date(1, 12, 1), [Format = "%y"]),
// Displays 1
Date.ToText(#date(2024, 1, 1), [Format = "%y"])
// Displays 24
}
in
Source
Identificatore di formato personalizzato "yy"
L'identificatore di formato personalizzato "yy" rappresenta l'anno come numero a due cifre. Se l'anno ha più di due cifre, nel risultato vengono visualizzate solo le due cifre di ordine inferiore. Se l'anno a due cifre ha meno di due cifre significative, al numero vengono anteposti tanti zeri quanti sono necessari per ottenere due cifre.
In un'operazione di analisi, un anno a due cifre analizzato usando l'identificatore di formato personalizzato "yy" viene interpretato in base al calendario corrente del provider di formato. Nell'esempio seguente viene analizzata la rappresentazione di stringa di una data con un anno a due cifre usando il calendario gregoriano predefinito delle impostazioni cultura en-US, che, in questo caso, sono le impostazioni cultura correnti. I valori restituiti per la data a quattro cifre dipendono dall'intervallo di 100 anni impostato dal sistema operativo.
let
// Define the date format and value
fmt = "dd-MMM-yy",
// Convert year 49 to a 4-digit year
firstDate = Text.Format("#{0}", { Date.FromText("24-Jan-49", [Format = fmt]) }),
// Convert year 50 to a 4-digit year
finalDate = Text.Format("#{0}", { Date.FromText("24-Jan-50", [Format = fmt]) }),
Heading = "Default Two Digit Year Range: 1950 - 2049",
result = {Heading, firstDate, finalDate}
in
result
// The example displays the following output:
// Default Two Digit Year Range: 1950 - 2049
// 1/24/2049
// 1/24/1950
L'esempio seguente include l'identificatore di formato personalizzato "yy" in una stringa di formato personalizzata.
let
Source =
{
Date.ToText(#date(1, 12, 1), [Format = "yy"]),
// Displays 01
Date.ToText(#date(2024, 1, 1), [Format = "yy"])
// Displays 24
}
in
Source
Identificatore di formato personalizzato "yyy"
L'identificatore di formato personalizzato "yyy" rappresenta l'anno con un minimo di tre cifre. Se l'anno ha più di tre cifre significative, queste vengono incluse nella stringa di risultato. Se l'anno ha meno di tre cifre, al numero vengono anteposti tanti zeri quanti sono necessari per ottenere tre cifre.
Nota
Per il calendario buddista tailandese, in cui sono previsti anni di cinque cifre, questo identificatore di formato consente di visualizzare tutte le cifre significative.
L'esempio seguente include l'identificatore di formato personalizzato "yyy" in una stringa di formato personalizzata.
let
Source =
{
Date.ToText(#date(1, 12, 1), [Format = "yyy"]),
// Displays 001
Date.ToText(#date(2024, 1, 1), [Format = "yyy"])
// Displays 2024
}
in
Source
Identificatore di formato personalizzato "yyyy"
L'identificatore di formato personalizzato "yyyy" rappresenta l'anno con un minimo di quattro cifre. Se l'anno ha più di quattro cifre significative, queste vengono incluse nella stringa di risultato. Se l'anno ha meno di quattro cifre, al numero vengono anteposti tanti zeri quanti sono necessari per ottenere quattro cifre.
Nota
Per il calendario buddista tailandese, in cui sono previsti anni di cinque cifre, questo identificatore di formato visualizza un minimo di quattro cifre.
L'esempio seguente include l'identificatore di formato personalizzato "yyyy" in una stringa di formato personalizzata.
let
Source =
{
Date.ToText(#date(1, 12, 1), [Format = "yyyy"]),
// Displays 0001
Date.ToText(#date(2024, 1, 1), [Format = "yyyy"])
// Displays 2024
}
in
Source
Identificatore di formato personalizzato "yyyyy"
L'identificatore di formato personalizzato "yyyyy" (più qualsiasi numero di identificatori "y" aggiuntivi) rappresenta l'anno con un minimo di cinque cifre. Se l'anno ha più di cinque cifre significative, queste vengono incluse nella stringa di risultato. Se l'anno ha meno di cinque cifre, al numero vengono anteposti tanti zeri quanto sono necessari per ottenere cinque cifre.
Se sono presenti identificatori "y" aggiuntivi, al numero vengono anteposti tanti zeri quanti sono necessari per ottenere il numero di identificatori "y".
L'esempio seguente include l'identificatore di formato personalizzato "yyyyy" in una stringa di formato personalizzata.
let
Source =
{
Date.ToText(#date(1, 12, 1), [Format = "yyyyy"]),
// Displays 00001
Date.ToText(#date(2024, 1, 1), [Format = "yyyyy"])
// Displays 02024
}
in
Source
Identificatore di formato "z" offset
Identificatore di formato personalizzato "z"
Con i valori DateTimeZone , l'identificatore di formato personalizzato "z" rappresenta l'offset con segno del fuso orario specificato dall'ora UTC (Coordinated Universal Time), misurato in ore. Lo scarto viene visualizzato sempre con un segno iniziale. Un segno più (+) indica le ore in più e un segno meno (-) le ore in meno rispetto all'ora UTC. Un offset a cifra singola viene formattato senza zero iniziale.
Nella tabella seguente viene illustrato come cambia il valore di offset a seconda della funzione DateTimeZone .
| Valore DateTimeZone | Valore offset |
|---|---|
| DateTimeZone.LocalNow | In Power Query Desktop l'offset firmato del fuso orario del sistema operativo locale dall'ora UTC. In Power Query Online restituisce +00. |
| DateTimeZone.UtcNow | Restituisce +0. |
Se l'identificatore di formato "z" viene usato senza altri identificatori di formato personalizzati, viene interpretato come identificatore di formato di data e ora standard e genera un errore di espressione. Per altre informazioni sull'uso di un singolo identificatore di formato, vedere Uso di identificatori di formato personalizzati singoli più avanti in questo articolo.
L'esempio seguente include l'identificatore di formato personalizzato "z" in una stringa di formato personalizzata in un sistema nel fuso orario U.S. Pacific.
let
Source =
{
DateTimeZone.ToText(DateTimeZone.LocalNow(), [Format="{0:%z}"]),
// Displays {0:-7} on Power Query Desktop
// Displays {0:+0} on Power Query Online
DateTimeZone.ToText(DateTimeZone.UtcNow(),[Format="{0:%z}"]),
// Displays {0:+0}
DateTimeZone.ToText(DateTimeZone.SwitchZone(
#datetimezone(2024, 8, 1, 0, 0, 0, 0, 0), 6),
[Format = "{0:%z}"]
)
// Displays {0:+6}
}
in
Source
Nota
Il valore restituito da DateTimeZone.LocalNow dipende dal fatto che si esegua Power Query in un computer locale o online. Ad esempio, nell'esempio precedente in un sistema nel fuso orario pacifico degli Stati Uniti, Power Query Desktop restituisce {0:-7} perché legge l'ora impostata nel computer locale. Tuttavia, Power Query Online restituisce {0:+0} perché legge l'ora impostata nelle macchine virtuali cloud, impostate su UTC.
Identificatore di formato personalizzato "zz"
Con i valori DateTimeZone , l'identificatore di formato personalizzato "zz" rappresenta l'offset con segno del fuso orario specificato dall'ora UTC, misurato in ore. Lo scarto viene visualizzato sempre con un segno iniziale. Un segno più (+) indica le ore in più e un segno meno (-) le ore in meno rispetto all'ora UTC. Un offset a cifra singola viene formattato con uno zero iniziale.
Nella tabella seguente viene illustrato come cambia il valore di offset a seconda della funzione DateTimeZone .
| Valore DateTimeZone | Valore offset |
|---|---|
| DateTimeZone.LocalNow | In Power Query Desktop l'offset firmato del fuso orario del sistema operativo locale dall'ora UTC. In Power Query Online restituisce +00. |
| DateTimeZone.UtcNow | Restituisce +00. |
L'esempio seguente include l'identificatore di formato personalizzato "zz" in una stringa di formato personalizzata in un sistema nel fuso orario pacifico degli Stati Uniti.
let
Source =
{
DateTimeZone.ToText(DateTimeZone.LocalNow(), [Format="{0:zz}"]),
// Displays {0:-07} on Power Query Desktop
// Displays {0:+00} on Power Query Online
DateTimeZone.ToText(DateTimeZone.UtcNow(),[Format="{0:zz}"]),
// Displays {0:+00}
DateTimeZone.ToText(DateTimeZone.SwitchZone(
#datetimezone(2024, 8, 1, 0, 0, 0, 0, 0), 6),
[Format = "{0:zz}"]
)
// Displays {0:+06}
}
in
Source
Nota
Il valore restituito da DateTimeZone.LocalNow dipende dal fatto che si esegua Power Query in un computer locale o online. Ad esempio, nell'esempio precedente in un sistema nel fuso orario pacifico degli Stati Uniti, Power Query Desktop restituisce {0:-07} perché legge l'ora impostata nel computer locale. Tuttavia, Power Query Online restituisce {0:+00} perché legge l'ora impostata nelle macchine virtuali cloud, impostate su UTC.
Identificatore di formato personalizzato "zzz"
Con i valori DateTimeZone , l'identificatore di formato personalizzato "zzz" rappresenta l'offset con segno del fuso orario specificato dall'ora UTC, misurato in ore e minuti. Lo scarto viene visualizzato sempre con un segno iniziale. Un segno più (+) indica le ore in più e un segno meno (-) le ore in meno rispetto all'ora UTC. Un valore di offset di una sola cifra viene formattato con uno zero iniziale.
Nella tabella seguente viene illustrato come cambia il valore di offset a seconda della funzione DateTimeZone .
| Valore DateTimeZoneValue | Valore offset |
|---|---|
| DateTimeZone.LocalNow | In Power Query Desktop l'offset firmato del fuso orario del sistema operativo locale dall'ora UTC. In Power Query Online restituisce +00. |
| DateTimeZone.UtcNow | Restituisce +00:00. |
L'esempio seguente include l'identificatore di formato personalizzato "zzz" in una stringa di formato personalizzata in un sistema nel fuso orario pacifico degli Stati Uniti.
let
Source =
{
DateTimeZone.ToText(DateTimeZone.LocalNow(), [Format="{0:zzz}"]),
// Displays {0:-07:00} on Power Query Desktop
// Displays {0:+00:00} on Power Query Online
DateTimeZone.ToText(DateTimeZone.UtcNow(),[Format="{0:zzz}"]),
// Displays {0:+00:00}
DateTimeZone.ToText(DateTimeZone.SwitchZone(
#datetimezone(2024, 8, 1, 0, 0, 0, 0, 0), 6),
[Format = "{0:zzz}"]
)
// Displays {0:+06:00}
}
in
Source
Nota
Il valore restituito da DateTimeZone.LocalNow dipende dal fatto che si esegua Power Query in un computer locale o online. Ad esempio, nell'esempio precedente in un sistema nel fuso orario pacifico degli Stati Uniti, Power Query Desktop restituisce {0:-07:00} perché legge l'ora impostata nel computer locale. Tuttavia, Power Query Online restituisce {0:+00:00} perché legge l'ora impostata nelle macchine virtuali cloud, impostate su UTC.
Identificatori di separatore di data e ora
Identificatore di formato personalizzato ":"
L'identificatore di formato personalizzato ":" rappresenta il separatore di ora che viene usato per distinguere ore, minuti e secondi. Il separatore di tempo localizzato appropriato viene recuperato dalle impostazioni cultura correnti o specificate.
Nota
Per modificare il separatore dell'ora per una particolare stringa di data e ora, specificare il carattere separatore all'interno di un delimitatore di stringa letterale. Ad esempio, la stringa con formato personalizzato hh_dd_ss produce una stringa in cui "_" (carattere di sottolineatura) è sempre usato come separatore dell'ora.
Se l'identificatore di formato ":" viene usato senza altri identificatori di formato personalizzati, viene interpretato come identificatore di formato di data e ora standard e genera un errore di espressione. Per altre informazioni sull'uso di un singolo identificatore di formato, vedere Uso di identificatori di formato personalizzati singoli più avanti in questo articolo.
Identificatore di formato personalizzato "/"
L'identificatore di formato personalizzato "/" rappresenta il separatore di data usato per distinguere anni, mesi e giorni. Il separatore di data localizzato appropriato viene recuperato dalle impostazioni cultura correnti o specificate.
Nota
Per modificare il separatore della data per una particolare stringa di data e ora, specificare il carattere separatore all'interno di un delimitatore di stringa letterale. Ad esempio, la stringa con formato personalizzato mm/dd/yyyy produce una stringa in cui "/" è sempre usato come separatore dell'ora.
Se l'identificatore di formato "/" viene usato senza altri identificatori di formato personalizzati, viene interpretato come identificatore di formato di data e ora standard e genera un errore di espressione. Per altre informazioni sull'uso di un singolo identificatore di formato, vedere Uso di identificatori di formato personalizzati singoli più avanti in questo articolo.
Valori letterali carattere
I caratteri seguenti in una stringa di formato di data e ora personalizzata sono riservati e vengono sempre interpretati come caratteri di formattazione o, nel caso di ", '/, e \, come caratteri speciali.
FHKMdfghmstyz%:/"'\
Tutti gli altri caratteri vengono sempre interpretati come valori letterali carattere e in un'operazione di formattazione vengono inclusi senza modifiche nella stringa di risultato. In un'operazione di analisi questi caratteri devono corrispondere esattamente ai caratteri nella stringa di input. Il confronto tiene conto di maiuscole e minuscole.
Nell'esempio seguente i caratteri "PST" (abbreviazione di Pacific Standard Time, Ora solare Pacifico) e "PDT" (abbreviazione di Pacific Daylight Time, Ora legale Pacifico) rappresentano il fuso orario locale in una stringa di formato. Si noti che la stringa è inclusa nella stringa di risultato e che una stringa che include la stringa del fuso orario locale viene analizzata correttamente.
let
#"Date Formats" = {"dd MMM yyyy hh:mm tt PST", "dd MMM yyyy hh:mm tt PDT"},
Source =
{
DateTime.ToText(#datetime(2024, 8, 18, 16, 50, 0), [Format = #"Date Formats"{1}]),
try DateTime.ToText(DateTime.FromText(
"25 Dec 2023 12:00 pm PST", [Format = #"Date Formats"{0}]))
otherwise "Unable to parse '" & "25 Dec 2023 12:00 pm PST" & "'"
}
in
Source
// The example displays the following output text:
// 18 Aug 2024 04:50 PM PDT
// 12/25/2023 12:00:00 PM
Esistono due modi per indicare che determinati caratteri devono essere interpretati come caratteri e non come caratteri riservati, per includerli in una stringa di risultato o eseguirne l'analisi in una stringa di input:
Usando un carattere di escape per ogni carattere riservato. Per altre informazioni, vedere Uso delle sequenze di escape.
Nell'esempio seguente i caratteri "pst" (abbreviazione di Pacific Standard Time, Ora solare Pacifico) rappresentano il fuso orario locale in una stringa di formato. Poiché sia "s" che "t" sono stringhe di formato personalizzato, perché siano interpretate come valori letterali carattere è necessario usare un carattere di escape per entrambe.
let #"Date Format" = "dd MMM yyyy hh:mm tt p's''t'", Source = { DateTime.ToText(#datetime(2024, 8, 18, 16, 50, 0), [Format = #"Date Format"]), try DateTime.ToText(DateTime.FromText( "25 Dec 2023 12:00 pm pst", [Format = #"Date Format"])) otherwise "Unable to parse '" & "25 Dec 2023 12:00 pm pst" & "'" } in Source // The example displays the following output text: // 18 Aug 2024 04:50 PM pst // 12/25/2016 12:00:00 PMRacchiudendo l'intera stringa letterale in apostrofi. L'esempio seguente è simile a quello precedente, ad eccezione del fatto che "pst" è racchiuso in apostrofi per indicare che l'intera stringa delimitata deve essere interpretata come valori letterali carattere.
let #"Date Format" = "dd MMM yyyy hh:mm tt 'pst'", Source = { DateTime.ToText(#datetime(2024, 8, 18, 16, 50, 0), [Format = #"Date Format"]), try DateTime.ToText(DateTime.FromText( "25 Dec 2023 12:00 pm pst", [Format = #"Date Format"])) otherwise "Unable to parse '" & "25 Dec 2023 12:00 pm pst" & "'" } in Source // The example displays the following output text: // 18 Aug 2024 04:50 PM pst // 12/25/2016 12:00:00 PM
Note
Uso di singoli identificatori di formato personalizzato
Una stringa di formato di data e ora personalizzata è costituita da due o più caratteri. I metodi di formattazione di data e ora interpretano qualsiasi stringa a carattere singolo come stringa di formato di data e ora standard. Se non riconoscono il carattere come identificatore di formato valido, generano un errore di espressione. Una stringa di formato costituita solo dall'identificatore "h" viene ad esempio interpretata come una stringa di formato di data e ora standard. In questo caso specifico, tuttavia, viene generata un'eccezione in quanto non esiste alcun identificatore di formato di data e ora standard "h".
Per usare qualsiasi identificatore di formato di data e ora personalizzato come unico identificatore in una stringa di formato (ovvero, per usare l'identificatore di formato personalizzato "d", "f", "F", "g", "h", "H", "K", "m", "M", "s", "t", "y", "z", ":" o "/" da solo), includere uno spazio prima o dopo l'identificatore oppure includere un identificatore di formato percentuale ("%") prima del singolo identificatore di data e ora personalizzato.
La stringa "%h" viene ad esempio interpretata come stringa di formato di data e ora personalizzato che consente di visualizzare l'ora rappresentata dal valore di data e ora corrente. È anche possibile usare la stringa di formato " h" o "h ", sebbene, in questo caso, verrà incluso uno spazio nella stringa di risultato insieme all'ora. Nell'esempio seguente vengono illustrate queste tre stringhe di formato.
let
date = #datetime(2024, 6, 15, 13, 45, 0),
Source =
{
Text.Format("'#{0}'", {DateTime.ToText(date, [Format = "%h"])}),
Text.Format("'#{0}'", {DateTime.ToText(date, [Format = " h"])}),
Text.Format("'#{0}'", {DateTime.ToText(date, [Format = "h "])})
}
in
Source
// The example displays a list with the following output text,
// with <sp> representing a space:
// '1'
// ' 1'
// '1 '
Uso delle sequenze di escape
I caratteri "d", "f", "F", "g", "h", "H", "K", "m", "M", "s", "t", "y", "z", ":" o "/" in una stringa di formato vengono interpretati come identificatori di formato personalizzati anziché come caratteri letterali.
Per impedire che un carattere venga interpretato come identificatore di formato, è possibile:
- Anteporre la barra rovesciata.
- Racchiuderlo con una virgoletta singola.
- Racchiuderlo tra due virgolette doppie.
Ognuno di questi caratteri funge da sequenza di escape. La sequenza di escape indica che il carattere o il carattere racchiuso seguente è un valore letterale di testo che deve essere incluso nella stringa di risultato invariato.
Per includere una virgoletta doppia in una stringa di risultato, è necessario eseguirne l'escape con un'altra virgoletta doppia ("").
Nell'esempio seguente vengono utilizzate sequenze di escape diverse per impedire all'operazione di formattazione di interpretare i caratteri "h" e "m" come identificatori di formato.
let
date = #datetime(2024, 6, 15, 13, 45, 30.90),
format1 = "h \h m \m",
format2 = "h ""h"" m ""m""",
format3 = "h 'h' m 'm'",
Source =
{
Text.Format("#{0} (#{1}) -> #{2}", {DateTime.ToText(date), format1, DateTime.ToText(date, format1)}),
Text.Format("#{0} (#{1}) -> #{2}", {DateTime.ToText(date), format2, DateTime.ToText(date, format2)}),
Text.Format("#{0} (#{1}) -> #{2}", {DateTime.ToText(date), format3, DateTime.ToText(date, format3)})
}
in
Source
// The example displays the following output text:
// 6/15/2024 1:45:30 PM (h \h m \m) -> 1 h 45 m
// 6/15/2024 1:45:30 PM (h "h" m "m") -> 1 h 45 m
// 6/15/2024 1:45:30 PM (h 'h' m 'm') -> 1 h 45 m