Mukautetut päivämäärän ja ajan muotoilun merkkijonot

Artikkeli
10/24/2024

Päivämäärän ja ajan muotoilumerkkijono määrittää päivämäärä-, päivämäärä/aika-, päivämäärä/aikavyöhyke- tai aika-arvon tekstiesityksen, joka on tuloksena muotoilutoiminnosta. Se voi myös määrittää päivämäärä- ja aika-arvon esityksen, joka vaaditaan jäsennystoiminnossa, jotta merkkijono voidaan muuntaa onnistuneesti päivämääräksi ja ajaksi. Mukautettu muotoilumerkkijono koostuu vähintään yhdestä mukautetusta päivämäärän ja kellonajan muodon määrityksestä. Merkkijono, joka ei ole vakiomuotoinen päivämäärän ja kellonajan muotoilumerkkijono , tulkitaan mukautetuksi päivämäärän ja kellonajan muotoilun merkkijonoksi.

Muotoilutoiminnoissa mukautettuja päivämäärän ja kellonajan muotoilun merkkijonoja voidaan käyttää päivämäärä- ja aikavyöhykeesiintymän -menetelmän kanssa ToText . Seuraavassa esimerkissä havainnollistetaan sen käyttötarkoituksia.

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

Toimintojen jäsennystoiminnoissa mukautettuja päivämäärän ja kellonajan muotoilun merkkijonoja voidaan käyttää funktioiden Date, DateTime, Time ja DateTimeZone kanssa. Nämä funktiot edellyttävät, että syötemerkkijono noudattaa tarkalleen tiettyä kaavaa, jotta jäsennystoiminto onnistuu. Seuraavassa esimerkissä havainnollistetaan DateTime.FromText-funktion kutsu jäsentää päivämäärä, jonka on sisällettävä kuukausi, päivä ja kaksinumeroinen vuosi.

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.

Seuraavassa taulukossa kuvataan mukautetun päivämäärän ja ajan muodon määrittimet ja näytetään kunkin muodon määritteen tuottama tulosmerkkijono. Oletusarvon mukaan tulosmerkkijonot kuvastavat en-US-maa-asetuksen muotoilukäytäntöjä. Jos tietty muotoilumäärite tuottaa lokalisoidun tulosmerkkijonon, esimerkki huomioi myös maa-asetuksen, jota tulosmerkkijono soveltaa. Lisätietoja mukautettujen päivämäärän ja kellonajan muotoilumerkkijonojen käyttämisestä on Huomautukset-osassa.

Muotomäärite	Kuvaus	Esimerkit
"d"	Kuukauden päivä 1:stä 31:een. Lisätietoja: "d"-mukautetun muodon määrite.	2009-06-01T13:45:30 -> 1 2009-06-15T13:45:30 -> 15
"dd"	Kuukauden päivä 01:stä 31:een. Lisätietoja: "dd"-mukautetun muodon määrite.	2009-06-01T13:45:30 -> 01 2009-06-15T13:45:30 -> 15
"ddd"	Viikonpäivän lyhennetty nimi. Lisätietoja: "ddd"-mukautetun muodon määrite.	2009-06-15T13:45:30 -> Ma (en-US) 2009-06-15T13:45:30 -> Пн (ru-RU) 2009-06-15T13:45:30 -> lun. (fr-FR)
"dddd"	Viikonpäivän koko nimi. Lisätietoja: "dddd"-mukautetun muodon määrite.	2009-06-15T13:45:30 -> Maanantai (en-US) 2009-06-15T13:45:30 -> понлник (ru-RU) 2009-06-15T13:45:30 -> lundi (fr-FR)
"f"	Päivämäärä- ja aika-arvon sekunnin kymmenesosat. Lisätietoja: Mukautetun muodon "f"-määrite.	2009-06-15T13:45:30.6170000 -> 6 2009-06-15T13:45:30.05 -> 0
"ff"	Päivämäärä- ja aika-arvon sekunnin sadasosat. Lisätietoja: Mukautetun muodon ff-määrite.	2009-06-15T13:45:30.6170000 -> 61 2009-06-15T13:45:30.0050000 -> 00
"fff"	Millisekunnit päivämäärä- ja aika-arvona. Lisätietoja: Mukautetun fff-muodon määrite.	15.6.2009 13.45.30.617 -> 617 15.6.2009 13.45.30.0005 -> 000
"ffff"	Päivämäärä- ja aika-arvon sekunnin kymmenen tuhatta sekuntiarvoa. Lisätietoja: Mukautettu "ffff"-muodon määrite.	2009-06-15T13:45:30.6175000 -> 6175 2009-06-15T13:45:30.0000500 -> 0000
"fffff"	Päivämäärä- ja aika-arvon sekunnin sadan sekunnin 100. Lisätietoja: Mukautetun fffff-muodon määrite.	2009-06-15T13:45:30.6175400 -> 61754 15.6.2009 13.45.30.000005 -> 00000
"ffffi"	Sekunnin miljoonasosat päivämäärä- ja aika-arvossa. Lisätietoja: Mukautetun muodon "ffffff"-määrite.	2009-06-15T13:45:30.6175420 -> 617542 2009-06-15T13:45:30.0000005 -> 000000
"fffffff"	Päivämäärä- ja aika-arvon sekunnin kymmenen miljoonasosaa. Lisätietoja: Mukautetun fffffff-muodon määrite.	2009-06-15T13:45:30.6175425 -> 6175425 2009-06-15T13:45:30.0001150 -> 0001150
"F"	Jos arvo ei ole nolla, sekunnin kymmenesosat päivämäärä- ja aika-arvossa. Lisätietoja: Mukautetun F-muodon määrite.	2009-06-15T13:45:30.6170000 -> 6 2009-06-15T13:45:30.0500000 -> (ei tulosta)
"FF"	Jos ei ole nolla, sekunnin sadasosat päivämäärä- ja aika-arvossa. Lisätietoja: Mukautetun FF-muodon määrite.	2009-06-15T13:45:30.6170000 -> 61 2009-06-15T13:45:30.0050000 -> (ei tulosta)
"FFF"	Jos arvo ei ole nolla, millisekunnit päivämäärä- ja aika-arvossa. Lisätietoja: Mukautetun FFF-muodon määrite.	2009-06-15T13:45:30.6170000 -> 617 2009-06-15T13:45:30.0005000 -> (ei tulosta)
"FFFF"	Jos ei ole nolla, sekunnin kymmenen tuhatta päivämäärä- ja aika-arvossa. Lisätietoja: Mukautetun FFFF-muodon määrite.	2009-06-15T13:45:30.5275000 -> 5275 2009-06-15T13:45:30.0000500 -> (ei tulosta)
"FFFFF"	Jos ei ole nolla, sekunnin sata tuhatta päivämäärä- ja aika-arvossa. Lisätietoja: Mukautettu FFFFF-muotomäärite.	2009-06-15T13:45:30.6175400 -> 61754 2009-06-15T13:45:30.0000050 -> (ei tulosta)
"FFFFFF"	Jos ei ole nolla, sekunnin miljoonasosat päivämäärä- ja aika-arvossa. Lisätietoja: Mukautettu FFFFFF-muotomäärite.	2009-06-15T13:45:30.6175420 -> 617542 2009-06-15T13:45:30.0000005 -> (ei tulosta)
"FFFFFFFFF"	Jos ei ole nolla, sekunnin kymmenen miljoonaa pistettä päivämäärä- ja aika-arvossa. Lisätietoja: Mukautettu FFFFFFF-muotomäärite.	2009-06-15T13:45:30.6175425 -> 6175425 2009-06-15T13:45:30.0001150 -> 000115
"g", "gg"	Kausi tai aikakausi. Lisätietoja: Mukautetun g- tai gg-muodon määrite.	2009-06-15T13:45:30.6170000 -> A.D.
"h"	Tunti käyttäen 12 tunnin kelloa 1:stä 12:een. Lisätietoja: "h"-mukautetun muodon määrite.	2009-06-15T01:45:30 -> 1 2009-06-15T13:45:30 -> 1
"hh"	Tunti käyttäen 12 tunnin kelloa 11:stä 12:een. Lisätietoja: Mukautetun hh-muodon määrite.	2009-06-15T01:45:30 -> 01 2009-06-15T13:45:30 -> 01
"H"	Tunti käyttämällä 24 tunnin kelloa 0:sta 23:een. Lisätietoja: "H"-mukautetun muodon määrite.	2009-06-15T01:45:30 -> 1 2009-06-15T13:45:30 -> 13
"HH"	Tunti käyttämällä 24 tunnin kelloa 00:sta 23:een. Lisätietoja: Mukautettu HH-muotomäärite.	2009-06-15T01:45:30 -> 01 2009-06-15T13:45:30 -> 13
"K"	Aikavyöhyketiedot. Lisätietoja: Mukautetun K-muodon määrite.	2009-06-15T13:45:30, määrittämätön -> 2009-06-15T13:45:30, Utc -> +00:00 2009-06-15T13:45:30, Paikallinen -> -07:00 (riippuu paikallisen tai pilvipalvelun tietokoneen asetuksista)
"m"	Minuutti, 0:sta 59:ään. Lisätietoja: Mukautetun m-muodon määrite.	2009-06-15T01:09:30 -> 9 2009-06-15T13:29:30 -> 29
"mm"	Minuutti, 00:sta 59:ään. Lisätietoja: Mukautetun mm-muodon määrite.	2009-06-15T01:09:30 -> 09 2009-06-15T01:45:30 -> 45
"M"	Kuukausi 1:stä 12:een. Lisätietoja: Mukautetun M-muodon määrite.	2009-06-15T13:45:30 -> 6
"MM"	Kuukausi 01:stä 12:een. Lisätietoja: Mukautetun MM-muodon määrite.	2009-06-15T13:45:30 -> 06
"MMM"	Kuukauden lyhennetty nimi. Lisätietoja: MMM:n mukautetun muodon määrite.	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"	Kuukauden koko nimi. Lisätietoja: Mukautetun MMMM-muodon määrite.	2009-06-15T13:45:30 -> Kesäkuu (en-US) 2009-06-15T13:45:30 -> juni (da-DK) 2009-06-15T13:45:30 -> Juni (zu-ZA)
"s"	Toinen, 0:sta 59:ään. Lisätietoja: "s"-mukautetun muodon määrite.	2009-06-15T13:45:09 -> 9
"ss"	Toinen, 00:sta 59:ään. Lisätietoja: "ss"-mukautetun muodon määrite.	2009-06-15T13:45:09 -> 09
"t"	AM/PM-suunnittelulaitteen ensimmäinen merkki. Lisätietoja: "t"-mukautetun muodon määrite.	2009-06-15T13:45:30 -> P (en-US) 2009-06-15T13:45:30 -> 午 (ja-JP) 2009-06-15T13:45:30 -> (fr-FR)
"tt"	AM/PM-suunnittelulaite. Lisätietoja: Mukautetun tt-muodon määrite.	2009-06-15T13:45:30 -> PM (en-US) 2009-06-15T13:45:30 -> 午後 (ja-JP) 2009-06-15T13:45:30 -> (fr-FR)
"y"	Vuosi, 0:sta 99:ään. Lisätietoja: Y-muotomäärite.	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"	Vuosi, 00-99. Lisätietoja: yy-muotomäärite.	0001-01-01T00:00:00 -> 01 0900-01-01T00:00:00 -> 00 1900-01-01T00:00:00 -> 00 2019-06-15T13:45:30 -> 19
"vvvv"	Vuosi, jossa on vähintään kolme numeroa. Lisätietoja: Yyyy-mukautetun muodon määrite.	0001-01-01T00:00:00 -> 001 0900-01-01T00:00:00 -> 900 1900-01-01T00:00:00 -> 1900 2009-06-15T13:45:30 -> 2009
"Vvvv"	Vuosi nelinumeroisena lukuna. Lisätietoja: Mukautettu v-muotomäärite.	0001-01-01T00:00:00 -> 0001 0900-01-01T00:00:00 -> 0900 1900-01-01T00:00:00 -> 1900 2009-06-15T13:45:30 -> 2009
"Vvvvv"	Vuosi viisinumeroisena lukuna. Lisätietoja: Mukautettu vv-muotomäärite.	0001-01-01T00:00:00 -> 00001 2009-06-15T13:45:30 -> 02009
"z"	Tunnit-siirtymä UTC-tasosta ilman edeltäviä nollia. Lisätietoja: Mukautetun z-muodon määrite.	2009-06-15T13:45:30-07:00 -> -7
"zz"	Tunnit-siirtymä UTC-arvosta, edeltävä nolla yksinumeroiselle arvolle. Lisätietoja: "zz"-mukautetun muodon määrite.	2009-06-15T13:45:30-07:00 -> -07
"zzz"	Tunnit ja minuutit ovat siirtymässä UTC-ajan tasosta. Lisätietoja: "zzz"-mukautetun muodon määrite.	2009-06-15T13:45:30-07:00 -> -07:00
":"	Kellonajan erotin. Lisätietoja: ":" mukautetun muodon määrite.	2009-06-15T13:45:30 -> : (en-US) 2009-06-15T13:45:30 -> . (it-IT) 2009-06-15T13:45:30 -> ( ja-JP)
"/"	Päivämääräerotin. Lisätietoja: Mukautetun muodon määritys /.	2009-06-15T13:45:30 -> / (en-US) 2009-06-15T13:45:30 -> - (ar-DZ) 2009-06-15T13:45:30 -> . (tr-TR)
"merkkijono" Merkkijono	Literaalimerkkijonon erotin. Lisätietoja: Merkkiliteraalit.	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
%	Määrittää seuraavan merkin mukautetun muodon määritteeksi. Lisätietoja: Yhden mukautetun muodon määrittimen käyttäminen.	2009-06-15T13:45:30 (%h) -> 1
\, "", '	Tilanvaihdot. Lisätietoja: Merkkiliteraalit ja Tilanvaihtojen käyttäminen.	2009-06-15T13:45:30 (h \h) -> 1 h 2009-06-15T13:45:30 (h ""h") -> 1 h 2009-06-15T13:45:30 (h 'h') -> 1 h
Mikä tahansa muu merkki	Merkki kopioidaan tulosmerkkijonoon muuttumattomana. Lisätietoja: Merkkiliteraalit.	2009-06-15T01:45:30 (arr hh:mm t) -> arr 01:45 A

Seuraavissa osioissa on lisätietoja kustakin mukautetun päivämäärän ja ajan muodon määrityksestä. Ellei toisin mainita, jokainen määrite tuottaa samanlaisen merkkijonoesityksen riippumatta siitä, käytetäänkö sitä Päivämäärä-, Päivämäärä/aika-, Päivämäärä/aikavyöhyke- vai Aika-arvon kanssa.

Päivä "d" -muodon määrite

"D"-mukautetun muodon määrite

Mukautetun muodon "d"-määrite edustaa kuukauden päivää lukuna 1:stä 31:een. Yksinumeroinen päivä muotoillaan ilman edeltävää nollaa.

Jos "d"-muodon määritettä käytetään ilman muita mukautetun muodon määritintä, se tulkitaan "d"-vakiopäivämäärän ja -ajan muodon määritteeksi. Lisätietoja yksittäisen muodon määritteen käyttämisestä on tämän artikkelin myöhemmässä kohdassa Single Custom Format Specifiers -ominaisuuden käyttäminen.

Seuraavassa esimerkissä on mukautetun d-muodon määrite useissa muotoilumerkkijonossa.

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

Takaisin taulukkoon

"dd"-mukautetun muodon määrite

"dd"-mukautettu muotoilumerkkijono edustaa kuukauden päivää lukuna 01:stä 31:een. Yksinumeroinen päivä muotoillaan edeltävän nollan kanssa.

Seuraavassa esimerkissä mukautetun dd-muodon määrite on mukautettu muotoilumerkkijono.

let
    Source =
    {
        DateTime.ToText(#datetime(2024, 1, 2, 6, 30, 15), [Format = "dd, MM", Culture = ""])
        // Displays 02, 01 
    }
in
    Source

Takaisin taulukkoon

"Ddd"-mukautetun muodon määrite

Mukautetun muodon "ddd"-määrite edustaa viikonpäivän lyhennettyä nimeä. Viikonpäivän lokalisoitu lyhennetty nimi noudetaan nykyisestä tai määritetystä maa-asetusta.

Seuraavassa esimerkissä "ddd"-mukautetun muodon määrite on mukautettu muotoilumerkkijono.

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

Takaisin taulukkoon

"Dddd"-mukautetun muodon määrite

Mukautetun muodon "dddd"-määritys (sekä mahdollinen määrä muita d-määrittimet) edustaa viikonpäivän koko nimeä. Viikonpäivän lokalisoitu nimi noudetaan nykyisestä tai määritetystä maa-asetusta.

Seuraavassa esimerkissä "dddd"-mukautettu muotomäärite on mukautettu muotoilumerkkijono.

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

Takaisin taulukkoon

Pienet kirjaimet sekunteja "f" murtolukumäärite

"f"-mukautetun muodon määrite

"f"-mukautetun muodon määrite edustaa sekuntien murtoluvun merkittävintä numeroa. Se tarkoittaa sekunnin kymmenesosaa päivämäärä- ja aika-arvossa.

Jos f-muodon määritettä käytetään ilman muita muotoilumääritettä, se tulkitaan f-vakiopäivämäärän ja -ajan muodon määritteeksi. Lisätietoja yksittäisen muodon määritteen käyttämisestä on tämän artikkelin myöhemmässä kohdassa Single Custom Format Specifiers -ominaisuuden käyttäminen.

Kun käytät f-muotomääritettä osana muotoilumerkkijonoa, joka on annettu murtosekuntien määrän jäsentämiseksi, f-muodon määritteiden määrä ilmaisee sen sekuntien murtoluvun merkittävimpien numeroiden määrän, joka on esitettävä merkkijonon jäsentämiseksi.

Seuraavassa esimerkissä mukautetun f-muodon määrite on mukautettu muotoilumerkkijono.

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

Takaisin taulukkoon

"ff"-mukautetun muodon määrite

"ff"-mukautetun muodon määrite edustaa sekuntien murtoluvun kahta merkittävintä numeroa; Se tarkoittaa sekunnin sadasosaa päivämäärä- ja aika-arvossa.

seuraavassa esimerkissä on mukautetun muotoilun ff-määrite mukautetussa muotoilumerkkijonossa.

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

Takaisin taulukkoon

"fff"-mukautetun muodon määrite

Mukautetun fff-muodon määrite edustaa sekuntien murto-osan kolmea merkittävintä numeroa. Se edustaa millisekunteja päivämäärä- ja aika-arvossa.

Seuraavassa esimerkissä mukautetun fff-muodon määrite on mukautettu muotoilumerkkijono.

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

Takaisin taulukkoon

"ffff"-mukautetun muodon määrite

Mukautetun ffff-muodon määrite edustaa sekuntien murtoluvun neljää merkittävintä numeroa. Se tarkoittaa päivämäärä- ja aika-arvon sekunnin 10 000:ta tuhatta.

Vaikka on mahdollista näyttää aika-arvon toisen osan kymmenen tuhatta, tämä arvo ei ehkä ole merkityksellinen. Päivämäärä- ja aika-arvojen tarkkuus riippuu järjestelmäkellon tarkkuudesta. Windows Server 2019- ja Windows 11 -käyttöjärjestelmissä kellon tarkkuus on noin 1 millisekuntia.

Takaisin taulukkoon

"fffff"-mukautetun muodon määrite

Mukautetun fffff-muodon määrite edustaa sekuntien murtoluvun viittä merkittävintä numeroa. Se edustaa sekunnin sataa tuhatta päivämäärä- ja aika-arvossa.

Vaikka on mahdollista näyttää aika-arvon toisen osan sadasosa, tämä arvo ei välttämättä ole merkityksellinen. Päivämäärä- ja aika-arvojen tarkkuus riippuu järjestelmäkellon tarkkuudesta. Windows Server 2019- ja Windows 11 -käyttöjärjestelmissä kellon tarkkuus on noin 1 millisekuntia.

Takaisin taulukkoon

"ffffff"-mukautetun muodon määrite

Mukautetun muodon ffffff-määrite edustaa sekuntien murtoluvun kuutta merkittävintä numeroa. Se tarkoittaa sekunnin miljoonia arvoja päivämäärä- ja aika-arvossa.

Vaikka on mahdollista näyttää aika-arvon toisen osan miljoonasosa, tämä arvo ei ehkä ole merkityksellinen. Päivämäärä- ja aika-arvojen tarkkuus riippuu järjestelmäkellon tarkkuudesta. Windows Server 2019- ja Windows 11 -käyttöjärjestelmissä kellon tarkkuus on noin 1 millisekuntia.

Takaisin taulukkoon

"fffffff"-mukautetun muodon määrite

Mukautetun fffffff-muodon määrite edustaa sekuntien murtoluvun seitsemää merkittävintä numeroa. Se edustaa sekunnin 10 miljoonaa pistettä päivämäärä- ja aika-arvossa.

Vaikka on mahdollista näyttää aika-arvon toisen osan kymmenen miljoonaa pistettä, tämä arvo ei ehkä ole merkityksellinen. Päivämäärä- ja aika-arvojen tarkkuus riippuu järjestelmäkellon tarkkuudesta. Windows Server 2019- ja Windows 11 -käyttöjärjestelmissä kellon tarkkuus on noin 1 millisekuntia.

Takaisin taulukkoon

Isojen kirjaimien sekunnit "F"-murtolukumäärite

Mukautetun F-muodon määrite

Mukautettu F-muotomäärite edustaa sekuntien murtoluvun merkittävintä numeroa. Se tarkoittaa sekunnin kymmenesosaa päivämäärä- ja aika-arvossa. Mitään ei näytetä, jos numero on nolla, eikä sekuntien määrää seuraavaa desimaalipistettä myöskään näytetä.

Jos F-muodon määritettä käytetään ilman muita muotoilumääritettä, se tulkitaan F-vakiopäivämäärän ja -ajan muodon määritteeksi. Lisätietoja yksittäisen muodon määritteen käyttämisestä on tämän artikkelin myöhemmässä kohdassa Single Custom Format Specifiers -ominaisuuden käyttäminen.

Jäsennyksen aikana käytettävien F-muotomääriteiden määrä ilmaisee sen sekuntien murtoluvun merkittävimpien numeroiden enimmäismäärän, joka voidaan esittää merkkijonon jäsentämiseksi onnistuneesti.

Seuraavassa esimerkissä mukautetun F-muodon määrite on mukautettu muotoilumerkkijono.

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

Takaisin taulukkoon

"FF":n mukautetun muodon määrite

Mukautetun FF-muodon määrite edustaa sekuntien murtoluvun kahta merkittävintä numeroa; Se tarkoittaa sekunnin sadasosaa päivämäärä- ja aika-arvossa. Lopussa olevat nollat eivät näy. Mitään ei näytetä, jos kaksi merkitsevää numeroa ovat nolla, eikä myöskään sekuntien määrää seuraavaa desimaalipistettä näytetä.

Seuraavassa esimerkissä mukautetun FF-muodon määrite on mukautettu muotoilumerkkijono.

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

Takaisin taulukkoon

Mukautetun FFF-muodon määrite

Mukautetun FFF-muodon määrite edustaa sekuntien murtoluvun kolmea merkittävintä numeroa. Se edustaa millisekunteja päivämäärä- ja aika-arvossa. Lopussa olevat nollat eivät näy. Mitään ei näytetä, jos kolme merkitsevää numeroa ovat nolla, ja siinä tapauksessa sekuntien määrää seuraavaa desimaalipistettä ei myöskään näytetä.

Seuraavassa esimerkissä on mukautetun FFF-muodon määrite mukautetussa muotoilumerkkijonossa.

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

Takaisin taulukkoon

"FFFF"-mukautetun muodon määrite

Mukautetun FFFF-muodon määrite edustaa sekuntien murtoluvun neljää merkittävintä numeroa; Se tarkoittaa päivämäärä- ja aika-arvon sekunnin 10 000:ta tuhatta. Lopussa olevat nollat eivät näy. Mitään ei näytetä, jos neljä merkitsevää numeroa ovat nolla, ja siinä tapauksessa sekuntien määrää seuraavaa desimaalipistettä ei myöskään näytetä.

Takaisin taulukkoon

Mukautetun FFFFF-muodon määrite

Mukautetun FFFFF-muodon määrite edustaa sekuntien murtoluvun viittä merkittävintä numeroa. Se edustaa sekunnin sataa tuhatta päivämäärä- ja aika-arvossa. Lopussa olevat nollat eivät näy. Mitään ei näytetä, jos viisi merkitsevää numeroa ovat nolla, eikä myöskään sekuntien määrää seuraavaa desimaalipistettä näytetä.

Takaisin taulukkoon

"FFFFFF"-mukautetun muodon määrite

Mukautetun FFFFFF-muodon määrite edustaa sekuntien murtoluvun kuutta merkittävintä numeroa. Se tarkoittaa sekunnin miljoonia arvoja päivämäärä- ja aika-arvossa. Lopussa olevat nollat eivät näy. Mitään ei näytetä, jos kuusi merkitsevää numeroa ovat nolla, ja siinä tapauksessa sekuntien määrää seuraavaa desimaalipistettä ei myöskään näytetä.

Takaisin taulukkoon

Mukautetun FFFFFFF-muodon määrite

Mukautetun FFFFFFF-muodon määrite edustaa sekuntien murtoluvun seitsemää merkittävintä numeroa. Se edustaa sekunnin 10 miljoonaa pistettä päivämäärä- ja aika-arvossa. Lopussa olevat nollat eivät näy. Mitään ei näytetä, jos seitsemän merkitsevää numeroa ovat nolla, eikä myöskään sekuntien määrää seuraavaa desimaalipistettä näytetä.

Takaisin taulukkoon

Era "g" -muodon määrite

Mukautetun g- tai gg-muodon määrite

Mukautetun muodon "g"- tai "gg"-määritykset (sekä mahdollinen määrä muita g-määrittimet) edustavat ajanjaksoa tai aikakautta, kuten A.D. Muotoilutoiminto ohittaa tämän määrityksen, jos muotoiltavan päivämäärän ei sisällä liittyvää ajanjaksoa tai aikamerkkijonoa.

Jos g-muodon määritettä käytetään ilman muita mukautetun muodon määritintä, se tulkitaan g-vakiomuotoiseksi päivämäärä- ja aikamuodon määritteeksi. Lisätietoja yksittäisen muodon määritteen käyttämisestä on tämän artikkelin myöhemmässä kohdassa Single Custom Format Specifiers -ominaisuuden käyttäminen.

Seuraava esimerkki sisältää mukautetun g-muodon määritteen mukautetussa muotoilumerkkijonossa.

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

Takaisin taulukkoon

Pienillä kirjaimilla tuntien "h"-muotomäärite

"h"-mukautetun muodon määrite

"h"-mukautetun muodon määrite edustaa tuntia lukuna 1:stä 12:een. Tuntia edustaa 12 tunnin kello, joka laskee koko tunnit keskiyöstä tai keskipäivästä alkaen. Tiettyä tuntia keskiyön jälkeen ei voi erottaa keskipäivän jälkeisestä samasta tunnista. Tuntia ei pyöristetä, ja yksinumeroinen tunti muotoillaan ilman edeltävää nollaa. Jos esimerkiksi kellonaika on 5:43 aamulla tai iltapäivällä, tämä mukautettu muotoilumäärite näyttää arvon "5".

Jos h-muotomääritettä käytetään ilman muita mukautetun muodon määritteet, se tulkitaan vakiopäivämäärän ja ajan muodon määritteeksi ja aiheuttaa lausekevirheen. Lisätietoja yksittäisen muodon määritteen käyttämisestä on tämän artikkelin myöhemmässä kohdassa Single Custom Format Specifiers -ominaisuuden käyttäminen.

Seuraavassa esimerkissä mukautetun h-muodon määrite on mukautettu muotoilumerkkijono.

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

Takaisin taulukkoon

"hh"-mukautetun muodon määrite

Mukautetun hh-muodon määrite (sekä mikä tahansa määrä muita h-määrittimet) edustaa tuntia lukuna 01:stä 12:een. Tuntia edustaa 12 tunnin kello, joka laskee koko tunnit keskiyöstä tai keskipäivästä alkaen. Tiettyä tuntia keskiyön jälkeen ei voi erottaa keskipäivän jälkeisestä samasta tunnista. Tuntia ei pyöristetä, ja yksinumeroinen tunti muotoillaan edeltävällä nollalla. Jos esimerkiksi kellonaika on 5:43 aamulla tai iltapäivällä, tämä muodon määrite näyttää arvon "05".

Seuraavassa esimerkissä mukautetun hh-muodon määrite on mukautettu muotoilumerkkijono.

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

Takaisin taulukkoon

Isojen kirjaimien tunnin H-muodon määrite

"H"-mukautetun muodon määrite

"H"-mukautetun muodon määrite edustaa tuntia lukuna 0:sta 23:een. Eli tuntia edustaa nollapohjainen 24 tunnin kello, joka laskee tunnit keskiyöstä lähtien. Yksinumeroinen tunti muotoillaan ilman ensimmäistä nollaa.

Jos H-muodon määritettä käytetään ilman muita mukautetun muodon määritteet, se tulkitaan vakiopäivämäärän ja ajan muodon määritteeksi ja aiheuttaa lausekevirheen. Lisätietoja yksittäisen muodon määritteen käyttämisestä on tämän artikkelin myöhemmässä kohdassa Single Custom Format Specifiers -ominaisuuden käyttäminen.

Seuraava esimerkki sisältää mukautetun H-muodon määritteen mukautetussa muotoilumerkkijonossa.

let
    Source =
    {
        DateTime.ToText(#datetime(2024, 1, 1, 6, 9, 1), [Format = "H:mm:ss", Culture = ""])
        // Displays 6:09:01
    }
in
    Source

Takaisin taulukkoon

"HH"-mukautetun muodon määrite

Mukautetun HH-muodon määrite (sekä mikä tahansa määrä muita H-määrittimet) edustaa tuntia lukuna 00:sta 23:een. Eli tuntia edustaa nollapohjainen 24 tunnin kello, joka laskee tunnit keskiyöstä lähtien. Yksinumeroinen tunti muotoillaan edeltävän nollan kanssa.

Seuraavassa esimerkissä on mukautetun HH-muodon määrite mukautetussa muotoilumerkkijonossa.

let
    Source =
    {
        DateTime.ToText(#datetime(2024, 1, 1, 6, 9, 1), [Format = "HH:mm:ss", Culture = ""])
        // Displays 06:09:01
    }
in
    Source

Takaisin taulukkoon

Aikavyöhykkeen "K"-muodon määrite

"K"-mukautetun muodon määrite

"K"-mukautetun muodon määrite edustaa päivämäärä- ja aika-arvon aikavyöhyketietoja. Kun tätä muotoilumääritettä käytetään DateTimeZone-arvojen kanssa, tulosmerkkijono määritetään seuraavasti:

Paikallisella aikavyöhykkeellä tämä määrite tuottaa tulosmerkkijonon, joka sisältää paikallisen siirtymän koordinoidusta yleisajasta (UTC), esimerkiksi "-07:00", jos kysely suoritetaan Power Query Desktopissa. Jos kyselysi suoritetaan Power Query Onlinessa, tulosmerkkijono ei tuota siirtymää UTC-ajasta, eli +00:00.
UTC-aikaa varten tulosmerkkijono ei tuota siirtymää UTC-ajasta. Eli "+00:00, joka edustaa UTC-päivämäärää.
Jos aika ei ole määritetty aikavyöhykkeellä, tulos on tyhjä.

Jos K-muodon määritettä käytetään ilman muita mukautetun muodon määritteet, se tulkitaan vakiopäivämäärän ja ajan muodon määritteeksi ja aiheuttaa lausekevirheen. Lisätietoja yksittäisen muodon määritteen käyttämisestä on tämän artikkelin myöhemmässä kohdassa Single Custom Format Specifiers -ominaisuuden käyttäminen.

Seuraavassa esimerkissä näytetään merkkijono, joka saadaan käyttämällä "K"-mukautettua muotomääritettä ja eri arvoja järjestelmässä Yhdysvaltain Tyynenmeren aikavyöhykkeellä.

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

Muistiinpano

DateTimeZone.LocalNow palauttama arvo riippuu siitä, käytätkö Power Queryä paikallisessa tietokoneessa vai verkossa. Esimerkiksi yllä olevassa esimerkissä järjestelmässä Yhdysvaltain Tyynenmeren aikavyöhykkeellä Power Query Desktop palaa -07:00 , koska se lukee paikallisessa tietokoneessasi määritetyn ajan. Power Query Online kuitenkin palauttaa arvon +00:00 , koska se lukee UTC-arvoksi määritettyä pilvi näennäiskoneissa määritettyä aikaa.

Takaisin taulukkoon

Minuutin "m"-muodon määrite

"M"-mukautetun muodon määrite

"m"-mukautetun muodon määrite edustaa minuuttia lukuna 0:sta 59:ään. Minuutti edustaa kokonaisia minuutteja, jotka ovat kuluneet viime tunnista lähtien. Yksinumeroinen minuutti muotoillaan ilman edeltävää nollaa.

Jos "m"-muodon määritettä käytetään ilman muita mukautetun muodon määritintä, se tulkitaan "m"-vakiopäivämäärän ja -ajan muodon määritteeksi. Lisätietoja yksittäisen muodon määritteen käyttämisestä on tämän artikkelin myöhemmässä kohdassa Single Custom Format Specifiers -ominaisuuden käyttäminen.

Seuraavassa esimerkissä mukautetun m-muodon määrite on mukautettu muotoilumerkkijono.

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

Takaisin taulukkoon

Mukautettu "mm"-muotomäärite

Mukautetun muodon "mm"-määrite (sekä mikä tahansa määrä muita "m"-määrittimet) edustaa minuuttia lukuna välillä 00–59. Minuutti edustaa kokonaisia minuutteja, jotka ovat kuluneet viime tunnista lähtien. Yksinumeroinen minuutti muotoillaan edeltävän nollan kanssa.

Seuraavassa esimerkissä mukautetun muotoilun määritin on "mm".

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

Takaisin taulukkoon

Kuukauden "M"-muodon määrite

"M"-mukautetun muodon määrite

Mukautetun M-muodon määrite edustaa kuukautta lukuna 1–12 (tai 1–13 kalentereille, joilla on 13 kuukautta). Yksinumeroinen kuukausi muotoillaan ilman edeltävää nollaa.

Jos M-muodon määritettä käytetään ilman muita mukautetun muodon määritintä, se tulkitaan "M"-vakiopäivämäärän ja -ajan muodon määritteeksi. Lisätietoja yksittäisen muodon määritteen käyttämisestä on tämän artikkelin myöhemmässä kohdassa Single Custom Format Specifiers -ominaisuuden käyttäminen.

Seuraavassa esimerkissä mukautetun M-muodon määrite on mukautettu muotoilumerkkijono.

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

Takaisin taulukkoon

"MM"-mukautetun muodon määrite

"MM"-mukautetun muodon määrite edustaa kuukautta lukuna 01:stä 12:een (tai 1:stä 13:een kalentereissa, joilla on 13 kuukautta). Yksinumeroinen kuukausi muotoillaan edeltävän nollan kanssa.

Seuraavassa esimerkissä mukautetun MM-muodon määrite on mukautettu muotoilumerkkijono.

let
    Source =
    {
        DateTime.ToText(#datetime(2024, 1, 2, 6, 30, 15), [Format = "dd, MM", Culture = ""])
        // Displays 02, 01
    }
in
    Source

Takaisin taulukkoon

MMM-mukautetun muodon määrite

"MMM"-mukautetun muodon määrite edustaa kuukauden lyhennettyä nimeä. Kuukauden lokalisoitu lyhennetty nimi noudetaan nykyisen tai määritetyn maa-asetuksen lyhennetyistä kuukausien nimistä. Jos mukautetussa muotoilumerkkijonossa on "d"- tai "dd"-muotomäärite, kuukauden nimi noudetaan sen sijaan lyhennetyistä genitive-nimistä.

Seuraavassa esimerkissä mukautetun MMM-muodon määrite on mukautettu muotoilumerkkijono.

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

Takaisin taulukkoon

"MMMM"-mukautetun muodon määrite

"MMMM"-mukautetun muodon määrite edustaa kuukauden koko nimeä. Kuukauden lokalisoitu nimi noudetaan nykyisestä tai määritetystä maa-asetusta. Jos mukautetussa muotoilumerkkijonossa on "d"- tai "dd"-muotomäärite, kuukauden nimi noudetaan sen sijaan lyhennetyistä genitive-nimistä.

Seuraavassa esimerkissä mukautetun MMMM-muodon määrite on mukautettu muotoilumerkkijono.

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

Takaisin taulukkoon

Sekunnit "s" -muodon määrite

"S"-mukautetun muodon määrite

"s"-mukautetun muodon määrite edustaa sekunteja lukuna 0:sta 59:ään. Tulos edustaa kokonaisia sekunteja, jotka ovat kuluneet viime minuutista. Yksinumeroinen sekunti muotoillaan ilman edeltävää nollaa.

Jos "s"-muotomääritettä käytetään ilman muita mukautetun muodon määritintä, se tulkitaan s-vakiopäivämäärän ja -ajan muodon määritteeksi. Lisätietoja yksittäisen muodon määritteen käyttämisestä on tämän artikkelin myöhemmässä kohdassa Single Custom Format Specifiers -ominaisuuden käyttäminen.

Seuraavassa esimerkissä on "s"-mukautetun muodon määrite mukautetussa muotoilumerkkijonossa.

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

Takaisin taulukkoon

"SS"-mukautetun muodon määrite

"Ss"-mukautetun muodon määrite (sekä mikä tahansa määrä muita s-määritteet) edustaa sekunteja lukuna 00–59. Tulos edustaa kokonaisia sekunteja, jotka ovat kuluneet viime minuutista. Yksinumeroinen sekunti muotoillaan edeltävän nollan kanssa.

Seuraavassa esimerkissä on "ss"-mukautetun muodon määrite mukautetussa muotoilumerkkijonossa.

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

Takaisin taulukkoon

Meridiem "t" -muodon määrite

"t"-mukautetun muodon määrite

"t"-mukautetun muodon määrite edustaa AM/PM-suunnittelutoiminnon ensimmäistä merkkiä. Asianmukainen lokalisoitu suunnittelulaite noudetaan nykyisestä tai tietystä maa-asetuksen perusteella. AM-suunnittelulaitetta käytetään aina klo 0.00.00–11.59.59.999. PM-suunnittelulaitetta käytetään aina klo 12.00–23.59.59.999.

Jos "t"-muodon määritettä käytetään ilman muita mukautetun muodon määritintä, se tulkitaan "t"-vakiopäivämäärän ja -ajan muodon määritteeksi. Lisätietoja yksittäisen muodon määritteen käyttämisestä on tämän artikkelin myöhemmässä kohdassa Single Custom Format Specifiers -ominaisuuden käyttäminen.

Seuraavassa esimerkissä "t"-mukautetun muodon määrite on mukautettu muotoilumerkkijono.

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

Takaisin taulukkoon

"Tt"-mukautetun muodon määrite

"tt"-mukautetun muodon määrite (sekä mikä tahansa määrä muita "t"-määrittäjiä) edustaa koko AM/PM-suunnittelutoimintoa. Asianmukainen lokalisoitu suunnittelulaite noudetaan nykyisestä tai tietystä maa-asetuksen perusteella. AM-suunnittelulaitetta käytetään aina klo 0.00.00–11.59.59.999. PM-suunnittelulaitetta käytetään aina klo 12.00–23.59.59.999.

Varmista, että käytät "tt"-määritetta kielille, joiden AM- ja PM-erot on pidettävä voimassa. Esimerkki on japani, jossa AM- ja PM-mittarit eroavat toisistaan toisessa meerissä ensimmäisen merkin sijaan.

Seuraavassa esimerkissä on mukautetun tt-muodon määrite mukautetussa muotoilumerkkijonossa.

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

Takaisin taulukkoon

Vuoden y-muodon määrite

"Y"-mukautetun muodon määrite

Mukautetun y-muodon määrite edustaa vuotta yksi- tai kaksinumeroisena lukuna. Jos vuosi sisältää yli kaksi numeroa, tuloksessa näkyy vain kaksi pienen tilauksen numeroa. Jos kaksinumeroisen vuoden ensimmäinen numero alkaa nollalla (esimerkiksi 2008), luku muotoillaan ilman edeltävää nollaa.

Jos y-muodon määritettä käytetään ilman muita mukautetun muodon määritintä, se tulkitaan y-vakiopäivämäärän ja -kellonajan muodon määritteeksi. Lisätietoja yksittäisen muodon määritteen käyttämisestä on tämän artikkelin myöhemmässä kohdassa Single Custom Format Specifiers -ominaisuuden käyttäminen.

Seuraavassa esimerkissä on mukautetun y-muodon määrite mukautetussa muotoilumerkkijonossa.

let
    Source =
    {
        Date.ToText(#date(1, 12, 1), [Format = "%y"]),
        // Displays 1

        Date.ToText(#date(2024, 1, 1), [Format = "%y"])
        // Displays 24
    }
in
    Source

Takaisin taulukkoon

Yy-mukautetun muodon määrite

"yy"-mukautetun muodon määrite edustaa vuotta kaksinumeroisena lukuna. Jos vuosi sisältää yli kaksi numeroa, tuloksessa näkyy vain kaksi pienen tilauksen numeroa. Jos kaksinumeroisella vuodella on alle kaksi merkitsevää numeroa, luku on täytetty edeltävillä nollilla, ja näin tuotetaan kaksi numeroa.

Jäsennystoiminnossa kaksinumeroinen vuosi, joka jäsennään mukautetun yy-muodon määritteen avulla, tulkitaan muotoilupalvelun nykyisen kalenterin perusteella. Seuraavassa esimerkissä jäsentää kaksinumeroisen vuoden päivämäärän merkkijonoesityksen käyttämällä en-US-maa-asetuksen oletusarvoista gregoriaanista kalenteria, joka on tässä tapauksessa nykyinen maa-asetus. Nelinumeroiselle päivämäärälle palautetut arvot riippuvat käyttöjärjestelmän määrittämästä 100 vuoden arvosta.

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

Seuraavassa esimerkissä on mukautetun yy-muodon määrite mukautetussa muotoilumerkkijonossa.

let
    Source =
    {
        Date.ToText(#date(1, 12, 1), [Format = "yy"]),
        // Displays 01

        Date.ToText(#date(2024, 1, 1), [Format = "yy"])
        // Displays 24
    }
in
    Source

Takaisin taulukkoon

"yyy"-mukautetun muodon määrite

"yyy"-mukautetun muodon määrite edustaa vuotta vähintään kolmella numerolla. Jos vuosi sisältää yli kolme merkitsevää numeroa, ne sisältyvät tulosmerkkijonoon. Jos vuodessa on alle kolme numeroa, luku on täytetty edeltävillä nollilla kolmen numeron tuottamiseksi.

Muistiinpano

Thai-buddhalaiselle kalenterille, jossa voi olla viisinumeroisia vuosia, tämä muotomäärite näyttää kaikki merkittävät numerot.

Seuraavassa esimerkissä on mukautetun yyy-muodon määrite mukautetussa muotoilumerkkijonossa.

let
    Source =
    {
        Date.ToText(#date(1, 12, 1), [Format = "yyy"]),
        // Displays 001

        Date.ToText(#date(2024, 1, 1), [Format = "yyy"])
        // Displays 2024
    }
in
    Source

Takaisin taulukkoon

"Vvvv"-mukautetun muodon määrite

"VVVV"-mukautetun muodon määrite edustaa vuotta vähintään neljällä numerolla. Jos vuosi sisältää yli neljä merkitsevää numeroa, ne sisältyvät tulosmerkkijonoon. Jos vuodessa on alle neljä numeroa, luku on täytetty edeltävillä nollilla neljän numeron tuottamiseksi.

Muistiinpano

Thai-buddhalaiselle kalenterille, jossa voi olla viisinumeroisia vuosia, tämä muotomäärite näyttää vähintään neljä numeroa.

Seuraavassa esimerkissä on mukautetun muotoilun yyyy-määrite mukautetussa muotoilumerkkijonossa.

let
    Source =
    {
        Date.ToText(#date(1, 12, 1), [Format = "yyyy"]),
        // Displays 0001

        Date.ToText(#date(2024, 1, 1), [Format = "yyyy"])
        // Displays 2024
    }
in
    Source

Takaisin taulukkoon

"Vvvvv"-mukautetun muodon määrite

"yyyyy"-mukautetun muodon määrite (sekä mahdollinen määrä muita y-määritteet) edustaa vuotta vähintään viidellä numerolla. Jos vuosi sisältää yli viisi merkitsevää numeroa, ne sisältyvät tulosmerkkijonoon. Jos vuosi sisältää alle viisi numeroa, luku on täytetty edeltävillä nollilla, ja näin tuotetaan viisi numeroa.

Jos on olemassa muita y-määritteet, luku on täytetty niin monella edeltävällä nollalla kuin on tarpeen y-määritteiden määrän tuottamiseksi.

Seuraavassa esimerkissä on mukautetun muotoilun yyyyy-määrite mukautetussa muotoilumerkkijonossa.

let
    Source =
    {
        Date.ToText(#date(1, 12, 1), [Format = "yyyyy"]),
        // Displays 00001

        Date.ToText(#date(2024, 1, 1), [Format = "yyyyy"])
        // Displays 02024
    }
in
    Source

Takaisin taulukkoon

Siirtymän "z"-muodon määrite

Mukautetun z-muodon määrite

DateTimeZone-arvoilla "z"-mukautetun muodon määrite edustaa määritetyn aikavyöhykkeen allekirjoitettua siirtymää koordinoidusta yleisajasta (UTC) tunteina mitattuna. Siirtymä näytetään aina edeltävän merkin kanssa. Plusmerkki (+) ilmaisee TUNNIT ennen UTC-aikaa, ja miinusmerkki (-) ilmaisee UTC-aikaa jäljessä olevat tunnit. Yksinumeroinen siirtymä muotoillaan ilman edeltävää nollaa.

Seuraavassa taulukossa näytetään, miten siirtymäarvo muuttuu DateTimeZone-funktion mukaan.

Päivämäärä, aika ja aikavyöhyke -arvo	Siirtymäarvo
DateTimeZone.LocalNow	Power Query Desktopissa paikallisen käyttöjärjestelmän aikavyöhykkeen allekirjoitettu siirtymä UTC-ajasta. Palauttaa Power Query Onlinessa arvon `+00`.
DateTimeZone.UtcNow	Palauttaa arvon `+0`.

Jos z-muodon määritettä käytetään ilman muita mukautetun muodon määritteet, se tulkitaan vakiopäivämäärän ja ajan muodon määritteeksi ja aiheuttaa lausekevirheen. Lisätietoja yksittäisen muodon määritteen käyttämisestä on tämän artikkelin myöhemmässä kohdassa Single Custom Format Specifiers -ominaisuuden käyttäminen.

Seuraava esimerkki sisältää mukautetun z-muodon määritteen mukautetussa muotoilumerkkijonossa järjestelmässä Yhdysvaltain Tyynenmeren aikavyöhykkeellä.

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

Muistiinpano

DateTimeZone.LocalNow palauttama arvo riippuu siitä, käytätkö Power Queryä paikallisessa tietokoneessa vai verkossa. Esimerkiksi yllä olevassa esimerkissä järjestelmässä Yhdysvaltain Tyynenmeren aikavyöhykkeellä Power Query Desktop palaa {0:-7} , koska se lukee paikallisessa tietokoneessasi määritetyn ajan. Power Query Online kuitenkin palauttaa arvon {0:+0} , koska se lukee UTC-arvoksi määritettyä pilvi näennäiskoneissa määritettyä aikaa.

Takaisin taulukkoon

"zz"-mukautetun muodon määrite

DateTimeZone-arvoilla "zz"-mukautetun muodon määrite edustaa määritetyn aikavyöhykkeen allekirjoitettua siirtymää UTC-arvosta mitattuna tunteina. Siirtymä näytetään aina edeltävän merkin kanssa. Plusmerkki (+) ilmaisee TUNNIT ennen UTC-aikaa, ja miinusmerkki (-) ilmaisee UTC-aikaa jäljessä olevat tunnit. Yksinumeroinen siirtymä muotoillaan edeltävän nollan kanssa .

Seuraavassa taulukossa näytetään, miten siirtymäarvo muuttuu DateTimeZone-funktion mukaan.

Päivämäärä, aika ja aikavyöhyke -arvo	Siirtymäarvo
DateTimeZone.LocalNow	Power Query Desktopissa paikallisen käyttöjärjestelmän aikavyöhykkeen allekirjoitettu siirtymä UTC-ajasta. Palauttaa Power Query Onlinessa arvon `+00`.
DateTimeZone.UtcNow	Palauttaa arvon `+00`.

Seuraava esimerkki sisältää mukautetun zz-muotomääriteen mukautetussa muotoilumerkkijonossa järjestelmässä Yhdysvaltain Tyynenmeren aikavyöhykkeellä.

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

Muistiinpano

DateTimeZone.LocalNow palauttama arvo riippuu siitä, käytätkö Power Queryä paikallisessa tietokoneessa vai verkossa. Esimerkiksi yllä olevassa esimerkissä järjestelmässä Yhdysvaltain Tyynenmeren aikavyöhykkeellä Power Query Desktop palaa {0:-07} , koska se lukee paikallisessa tietokoneessasi määritetyn ajan. Power Query Online kuitenkin palauttaa arvon {0:+00} , koska se lukee UTC-arvoksi määritettyä pilvi näennäiskoneissa määritettyä aikaa.

Takaisin taulukkoon

"Zzz"-mukautetun muodon määrite

DateTimeZone-arvoilla "zzz"-mukautetun muodon määrite edustaa määritetyn aikavyöhykkeen allekirjoitettua siirtymää UTC-arvosta mitattuna tunteina ja minuutteina. Siirtymä näytetään aina edeltävän merkin kanssa. Plusmerkki (+) ilmaisee TUNNIT ennen UTC-aikaa, ja miinusmerkki (-) ilmaisee UTC-aikaa jäljessä olevat tunnit. Yksinumeroinen siirtymä muotoillaan edeltävän nollan kanssa.

Seuraavassa taulukossa näytetään, miten siirtymäarvo muuttuu DateTimeZone-funktion mukaan.

DateTimeZoneValue-arvo	Siirtymäarvo
DateTimeZone.LocalNow	Power Query Desktopissa paikallisen käyttöjärjestelmän aikavyöhykkeen allekirjoitettu siirtymä UTC-ajasta. Palauttaa Power Query Onlinessa arvon `+00`.
DateTimeZone.UtcNow	Palauttaa arvon `+00:00`.

Seuraava esimerkki sisältää mukautetun zzz-muotomääriteen mukautetussa muotoilumerkkijonossa järjestelmässä Yhdysvaltain Tyynenmeren aikavyöhykkeellä.

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

Muistiinpano

DateTimeZone.LocalNow palauttama arvo riippuu siitä, käytätkö Power Queryä paikallisessa tietokoneessa vai verkossa. Esimerkiksi yllä olevassa esimerkissä järjestelmässä Yhdysvaltain Tyynenmeren aikavyöhykkeellä Power Query Desktop palaa {0:-07:00} , koska se lukee paikallisessa tietokoneessasi määritetyn ajan. Power Query Online kuitenkin palauttaa arvon {0:+00:00} , koska se lukee UTC-arvoksi määritettyä pilvi näennäiskoneissa määritettyä aikaa.

Takaisin taulukkoon

Päivämäärän ja kellonajan erotinmäärite

":" mukautetun muodon määrite

":" mukautetun muodon määrite edustaa ajan erotinta, jota käytetään tuntien, minuuttien ja sekuntien erottamiseen. Asianmukainen lokalisoitu kellonajan erotin noudetaan nykyisestä tai määritetystä maa-asetusta.

Muistiinpano

Jos haluat muuttaa tietyn päivämäärän ja ajan merkkijonon ajan erotinta, määritä erotinmerkki merkkijonon literaalierottimessa. Esimerkiksi mukautettu muotoilumerkkijono hh_dd_ss tuottaa tulosmerkkijonon, jossa "_" (alaviiva) käytetään aina ajan erottimena.

Jos ":" muotoilumääritettä käytetään ilman muita mukautetun muodon määritteet, se tulkitaan vakiopäivämäärän ja ajan muodon määritteeksi ja aiheuttaa lausekevirheen. Lisätietoja yksittäisen muodon määritteen käyttämisestä on tämän artikkelin myöhemmässä kohdassa Single Custom Format Specifiers -ominaisuuden käyttäminen.

Takaisin taulukkoon

"/"-mukautetun muodon määrite

"/"-mukautetun muodon määrite edustaa päivämääräerotinta, jota käytetään vuosien, kuukausien ja päivien erottamiseen. Asianmukainen lokalisoitu päivämääräerotin noudetaan nykyisestä tai määritetystä maa-asetusta.

Muistiinpano

Jos haluat muuttaa tietyn päivämäärän ja ajan merkkijonon päivämääräerotinta, määritä erotinmerkki literaalimerkkijonon erottimen sisällä. Esimerkiksi mukautettu muotoilumerkkijono mm/dd/yyyy tuottaa tulosmerkkijonon, jossa "/" käytetään aina päivämääräerottimena.

Jos "/"-muotomääritettä käytetään ilman muita mukautetun muodon määritteet, se tulkitaan vakiopäivämäärän ja ajan muodon määritykseksi ja aiheuttaa lausekevirheen. Lisätietoja yksittäisen muodon määritteen käyttämisestä on tämän artikkelin myöhemmässä kohdassa Single Custom Format Specifiers -ominaisuuden käyttäminen.

Takaisin taulukkoon

Merkkiliteraalit

Seuraavat mukautetun päivämäärän ja kellonajan muotoilun merkkijonon merkit varataan, ja ne tulkitaan aina muotoilu merkeiksi tai , "', /ja \, erikoismerkeistä.

Kaikki muut merkit tulkitaan aina merkkiliteraaliksi, ja muotoilutoiminnossa ne sisällytetään tulosmerkkijonoon muuttumattomina. Jäsennystoiminnossa niiden on vastattava syötemerkkijonon merkkejä tarkasti. Vertailussa kirjainkoko on merkitsevä.

Seuraavassa esimerkissä literaalimerkit "PST" (Tyynenmeren normaaliaika) ja "PDT" (PDT) edustavat paikallista aikavyöhykettä muotoilumerkkijonossa. Huomaa, että merkkijono sisältyy tulosmerkkijonoon ja että myös paikallisen aikavyöhykemerkkijonon sisältävä merkkijono jäsentää onnistuneesti.

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

On olemassa kaksi tapaa, joilla merkit tulkitaan literaalimerkiksi, ei varamerkkijonoksi, jotta ne voidaan sisällyttää tulosmerkkijonoon tai jäsentää onnistuneesti syötemerkkijonossa:

Lisäämällä kaikki varatut merkit ohjausmerkkien yli. Lisätietoja on kohdassa Tilanvaihtojen käyttäminen.

Seuraava esimerkki sisältää literaalimerkit "pst" (Tyynenmeren normaaliaikaa varten), jotka edustavat paikallista aikavyöhykettä muotoilumerkkijonossa. Koska sekä "s" että "t" ovat mukautettuja muotoilumerkkijonoja, molemmat merkit on poistettava, jotta ne tulkitaan merkkiliteraaliksi.

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 PM

Sulkemalla koko literaalimerkkijono heittomerkeissä. Seuraava esimerkki on kuin edellinen, paitsi että "pst" on sisällytetty heittomerkeihin ilmaisemaan, että koko eroteltu merkkijono tulee tulkita merkkiliteraalina.

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

Muistiinpanot

Yhden mukautetun muotoilun määrittimen käyttäminen

Mukautettu päivämäärän ja kellonajan muotoilumerkkijono koostuu kahdesta tai useammasta merkistä. Päivämäärän ja kellonajan muotoilumenetelmät tulkitsevat minkä tahansa yksimerkkisen merkkijonon vakiomuotoiseksi päivämäärän ja kellonajan muotoilumerkkijonoksi. Jos he eivät tunnista merkkiä kelvolliseksi muotomääriteeksi, he heittävät lausekevirheen. Esimerkiksi muotoilumerkkijono, joka koostuu vain määrityksestä "h", tulkitaan vakiomuotoiseksi päivämäärän ja kellonajan muotoilun merkkijonoksi. Tässä tapauksessa tapahtuu kuitenkin poikkeus, koska "h"-vakiopäivämäärän ja -ajan muodon määritystä ei ole.

Jos haluat käyttää mitä tahansa mukautetun päivämäärän ja ajan muodon määritistä ainoana määriteenä muotoilumerkkijonossa (eli jos haluat käyttää "d", "f", "F", "g", "h", "H", "K", "m", "M", "s", "t", "y", "z", ":"tai "/" mukautettu muotomäärite yksinään), lisää välilyönti ennen määritetä tai sen jälkeen tai sisällytä prosenttimuodon määrite ("%") ennen yksittäistä mukautettua päivämäärän ja ajan määritystä.

Esimerkiksi "%h" tulkitaan mukautetuksi päivämäärän ja kellonajan muotoilumerkkijonoksi, joka näyttää nykyisen päivämäärä- ja aika-arvon edustaman tunnin. Voit käyttää myös muotoilumerkkijonoa "h" tai "h", vaikka se sisältääkin välilyönnin tulosmerkkijonossa tunnin ohella. Seuraavassa esimerkissä havainnollistetaan nämä kolme muotoilumerkkijonoa.

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 '

Tilanvaihtojen käyttäminen

Muotoilumerkkijonon "d", "f", "F", "g", "h", "H", "K", "m", "M", "s", "t", "y", "z", ":"tai "/" merkit tulkitaan mukautettuina muotoilumääriteinä literaalimerkkien sijaan.

Voit estää merkin tulkitsemisen muodon määritteeksi seuraavasti:

Kirjoita sen eteen kenoviiva.
Ympäröi se heittomerkillä.
Ympäröi se kahdella lainausmerkeillä.

Jokainen näistä merkeistä toimii tilanvaihdona. Tilanvaihto ilmaisee, että seuraava merkki tai ympäröity merkki on tekstiliteraali, joka tulee sisällyttää tulosmerkkijonoon muuttumattomana.

Jos haluat sisällyttää tulosmerkkijonoon lainausmerkin, sinun on vältettävä se toisella lainausmerkillä ("").

Seuraavassa esimerkissä käytetään erilaisia tilanvaihtoja, jotta muotoilutoiminto ei tulkitse "h"- ja "m"-merkkejä muotoilumääriteiksi.

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

Jaa

Mukautetut päivämäärän ja ajan muotoilun merkkijonot

Päivä "d" -muodon määrite

"D"-mukautetun muodon määrite

"dd"-mukautetun muodon määrite

"Ddd"-mukautetun muodon määrite

"Dddd"-mukautetun muodon määrite

Pienet kirjaimet sekunteja "f" murtolukumäärite

"f"-mukautetun muodon määrite

"ff"-mukautetun muodon määrite

"fff"-mukautetun muodon määrite

"ffff"-mukautetun muodon määrite

"fffff"-mukautetun muodon määrite

"ffffff"-mukautetun muodon määrite

"fffffff"-mukautetun muodon määrite

Isojen kirjaimien sekunnit "F"-murtolukumäärite

Mukautetun F-muodon määrite

"FF":n mukautetun muodon määrite

Mukautetun FFF-muodon määrite

"FFFF"-mukautetun muodon määrite

Mukautetun FFFFF-muodon määrite

"FFFFFF"-mukautetun muodon määrite

Mukautetun FFFFFFF-muodon määrite

Era "g" -muodon määrite

Mukautetun g- tai gg-muodon määrite

Pienillä kirjaimilla tuntien "h"-muotomäärite

"h"-mukautetun muodon määrite

"hh"-mukautetun muodon määrite

Isojen kirjaimien tunnin H-muodon määrite

"H"-mukautetun muodon määrite

"HH"-mukautetun muodon määrite

Aikavyöhykkeen "K"-muodon määrite

"K"-mukautetun muodon määrite

Minuutin "m"-muodon määrite

"M"-mukautetun muodon määrite

Mukautettu "mm"-muotomäärite

Kuukauden "M"-muodon määrite

"M"-mukautetun muodon määrite

"MM"-mukautetun muodon määrite

MMM-mukautetun muodon määrite

"MMMM"-mukautetun muodon määrite

Sekunnit "s" -muodon määrite

"S"-mukautetun muodon määrite

"SS"-mukautetun muodon määrite

Meridiem "t" -muodon määrite

"t"-mukautetun muodon määrite

"Tt"-mukautetun muodon määrite

Vuoden y-muodon määrite

"Y"-mukautetun muodon määrite

Yy-mukautetun muodon määrite

"yyy"-mukautetun muodon määrite

"Vvvv"-mukautetun muodon määrite

"Vvvvv"-mukautetun muodon määrite

Siirtymän "z"-muodon määrite

Mukautetun z-muodon määrite

"zz"-mukautetun muodon määrite

"Zzz"-mukautetun muodon määrite

Päivämäärän ja kellonajan erotinmäärite

":" mukautetun muodon määrite

"/"-mukautetun muodon määrite

Merkkiliteraalit

Muistiinpanot

Yhden mukautetun muotoilun määrittimen käyttäminen

Tilanvaihtojen käyttäminen

Liittyvä sisältö

Palaute

Lisäresursseja