Jaa

Vakiopäivämäärän ja ajan muotoilun merkkijonot

  • Artikkeli

Vakiomuotoinen päivämäärä- ja aikamuotomerkkijono käyttää muotomääriteenä yksittäistä merkkiä ajan ja päivämäärän arvon tekstiesityksen määrittämiseen. Jokainen päivämäärän ja ajan muotoilun merkkijono, joka sisältää useamman kuin yhden merkin, välilyönti mukaan lukien, tulkitaan mukautetuksi päivämäärän ja kellonajan muotoilun merkkijonoksi. Vakiomuotoista tai mukautettua muotoilumerkkijonoa voidaan käyttää määrittämään muotoilutoiminnon tuloksena oleva tekstiesitys.

Muotomääritetaulukko

Seuraavassa taulukossa kuvataan vakiopäivämäärän ja -kellonajan muodon määritykset.

Muotomäärite Kuvaus Esimerkit
"d" Lyhyt päivämäärämalli.

Lisätietoja: Lyhyen päivämäärän ("d") muodon määrite.		 2009-06-15T13:45:30 -> 15.6.2009 (en-US)

2009-06-15T13:45:30 -> 15/06/2009 (fr-FR)

2009-06-15T13:45:30 -> 2009/06/15 (ja-JP)
"D" Pitkä päivämäärämalli.

Lisätietoja: Pitkän päivämäärän ("D") muodon määrite.		 2009-06-15T13:45:30 -> Monday, June 15, 2009 (en-US)

2009-06-15T13:45:30 -> поннллник, 15 инь 2009 г. (ru-RU)

2009-06-15T13:45:30 -> Montag, 15. Juni 2009 (de-DE)
"f" Koko päivämäärä/aika-malli (lyhyt aika).

Lisätietoja: Koko päivämäärän lyhyt kellonaika ("f") -muodon määrite.		 2009-06-15T13:45:30 -> Maanantai, Kesäkuu 15, 2009 13:45 PM (en-US)

2009-06-15T13:45:30 -> den 15 juni 2009 13:45 (sv-SE)

2009-06-15T13:45:30 -> Εειιιιι, 15 Ιιινιιι 2009 1:45 μμ (el-GR)
"F" Täysi päivämäärä/aika-malli (pitkä aika).

Lisätietoja: Koko päivämäärän pitkä aika ("F") -muotomäärite.		 2009-06-15T13:45:30 -> Monday, June 15, 2009 1:45:30 PM (en-US)

2009-06-15T13:45:30 -> den 15 juni 2009 13:45:30 (sv-SE)

2009-06-15T13:45:30 -> Εειιιιι, 15 Ιιινιιι 2009 1:45:30 μμ (el-GR)
"g" Yleinen päivämäärä/aika-malli (lyhyt aika).

Lisätietoja: Yleinen päivämäärän lyhyt kellonaika ("g") -muodon määrite.		 2009-06-15T13:45:30 -> 6/15/2009 13:45 PM (en-US)

2009-06-15T13:45:30 -> 15/06/2009 13:45 (es-ES)

2009-06-15T13:45:30 -> 2009/6/15 13:45 (zh-CN)
"G" Yleinen päivämäärä/aika-malli (pitkä aika).

Lisätietoja: Yleisen päivämäärän pitkän ajan ("G") muodon määrite.		 2009-06-15T13:45:30 -> 6/15/2009 13:45:30 PM (en-US)

2009-06-15T13:45:30 -> 06.15.2009 13.45.30 (es-ES)

2009-06-15T13:45:30 -> 2009/6/15 13:45:30 (zh-CN)
"M", "m" Kuukausi/päivä-malli.

Lisätietoja: Kuukauden ("M", "m") muodon määrite.		 2009-06-15T13:45:30 -> Kesäkuu 15 (en-US)

2009-06-15T13:45:30 -> 15. juni (da-DK)

2009-06-15T13:45:30 -> 15 Juni (id-ID)
"O", "o" matka-päivämäärä/aika-malli.

Lisätietoja: Kiertomatka ("O", "o") -muotomäärite.		 2009-06-15T13:45:30 (paikallinen) --> 2009-06-15T13:45:30.000000-07:00

2009-06-15T13:45:30 (Utc) --> 2009-06-15T13:45:30.000000+00:00

2009-06-15T13:45:30 (määrittämätön) --> 2009-06-15T13:45:30.0000000
"R", "r" RFC1123 mallin.

Lisätietoja: RFC1123 ("R", "r") -muotomäärite.		 2009-06-15T13:45:30 -> Ma, 15 kesäkuuta 2009 13:45:30 GMT
"s" Lajiteltava päivämäärä/aika-malli.

Lisätietoja: Lajittelutavan määrite.		 2009-06-15T13:45:30 (paikallinen) -> 2009-06-15T13:45:30

2009-06-15T13:45:30 (Utc) -> 2009-06-15T13:45:30
"t" Lyhyt aikamalli.

Lisätietoja: Lyhyen ajan ("t") muodon määrite.		 2009-06-15T13:45:30 -> 13:45 PM (en-US)

2009-06-15T13:45:30 -> 13:45 (h-HR)

2009-06-15T13:45:30 -> 01:45 A (ar-EG)
"T" Pitkä aikamalli.

Lisätietoja: Pitkän ajan ("T") muodon määrite.		 2009-06-15T13:45:30 -> 1:45:30 PM (en-US)

2009-06-15T13:45:30 -> 13:45:30 (h-HR)

2009-06-15T13:45:30 -> 01:45:30 Kärry (ar-EG)
"u" Yleinen lajiteltava päivämäärä/aika-malli.

Lisätietoja: Yleinen lajittelumuoto ("u") -muotomäärite.		 2009-06-15T13:45:30 -> 2009-06-15 13:45:30Z
"Y", "Y" Vuosikuukausi.

Lisätietoja: Vuosikuukauden ("Y") muodon määrite.		 2009-06-15T13:45:30 -> Kesäkuu 2009 (en-US)

2009-06-15T13:45:30 -> juni 2009 (da-DK)

2009-06-15T13:45:30 -> Juni 2009 (id-ID)
Mikä tahansa muu yksittäinen merkki Tuntematon määrite. Aiheuttaa suorituksenaikaisen lausekkeen virheen.

Vakiomuotomerkkijonojen toiminta

Muotoilutoiminnossa vakiomuotomerkkijono on vain alias mukautetulle muotoilumerkkijonolle. Kun aliasta käytetään viittaamaan mukautettuun muotoilumerkkijonoon, sen etuna on, että vaikka alias säilyy muuttumattomana, myös mukautettu muotoilumerkkijono voi vaihdella. Tämä on tärkeää, koska päivämäärä- ja aika-arvojen merkkijonoesitykset vaihtelevat yleensä maa-asetuksen mukaan. Esimerkiksi "d"-vakiomuotomerkkijono ilmaisee, että päivämäärän ja kellonajan arvo näytetään käyttäen lyhyttä päivämäärämallia. Muuttumattoman maa-asetuksen malli on "KK/pp/vvvv". Fr-FR-kulttuuri on "pp/KK/VVVV". Ja-JP-maa-asetus on "vv/KK/pp".

Jos muotoilutoiminnon vakiomuotoinen muotoilumerkkijono yhdistetään tietyn maa-asetuksen mukautettuun muotoilumerkkijonoon, sovelluksesi voi määrittää tietyn maa-asetuksen, jonka mukautettuja muotoilumerkkijonoja käytetään jollakin seuraavista tavoista:

  • Voit käyttää oletusarvoista (tai nykyistä) maa-asetusta. Seuraavassa esimerkissä näytetään päivämäärä käyttäen nykyisen maa-asetuksen lyhyttä päivämäärämuotoa. Tässä tapauksessa nykyinen maa-asetus on en-US.

    let
    Source =
    {
        Date.ToText(#date(2024, 3, 15), [Format = "d"])
        //Displays 3/15/2024
    }
in
    Source

  • Voit välittää maa-asetuksen, jota käytetään päivämäärän muotoiluun kyseisen maa-asetuksen sääntöjen mukaisesti. Seuraavassa esimerkissä näytetään päivämäärä käyttäen pt-BR-maa-asetuksen lyhyttä päivämäärämuotoa.

    let
    Source =
    {
        Date.ToText(#date(2024, 3, 15), [Format = "d", Culture = "pt-BR"])
        //Displays 15/03/2024
   }
in
    Source

Joissakin tapauksissa vakiomuotoinen muotoilumerkkijono toimii kätevänä lyhenteenä pidemmälle mukautetulle muotoilumerkkijonoa varten, joka on muuttumattomana. Tähän luokkaan kuuluu neljä vakiomuotoista merkkijonoa: "O" (tai "o"), "R" (tai "r"), "s" ja "u". Nämä merkkijonot vastaavat mukautettuja muotoilumerkkijonoja, jotka on määritetty muuttumattoman maa-asetuksen mukaisesti. Ne tuottavat päivämäärä- ja aika-arvojen merkkijonoesitykset, jotka on tarkoitettu samanlaisiksi kaikissa maa-asetussä. Seuraavassa taulukossa on tietoja näistä neljästä vakiopäivämäärän ja kellonajan muotomerkkijonosta.

Vakiomuotoinen muotoilumerkkijono Määrittäjä Mukautettu muotoilumerkkijono
"O" tai "o" Ei ole yyyy'-'MM'-dd'T'HH':'mm':'ss'. fffffffK
"R" tai "r" IETF RFC 1123 määritys ddd, dd MMM yyyy HH':'mm':'ss 'GMT'
"s" ISO 8601 yyyy'-'MM'-dd'T'HH':'mm':'ss
"u" Lajiteltavissa, koska se käyttää edeltäviä nollia vuodelle, kuukaudelle, päivälle, tunnissa, minuutille ja sekunnille yyyy'-'MM'-dd HH':'mm':'ss'Z'

Vakiomuotoisia merkkijonoja voidaan käyttää myös jäsennystoiminnoissa, jotka edellyttävät syötemerkkijonoa vastaamaan tarkasti tiettyä mallia, jotta jäsennystoiminto onnistuu. Monet vakiomuotoiset muotoilumerkkijonot yhdistetään useisiin mukautettuihin muotoilumerkkijonoon, joten päivämäärän ja ajan arvo voidaan esittää eri muodoissa ja jäsennystoiminto onnistuu edelleen.

Seuraavissa osissa kuvataan Date-, DateTime-, DateTimeZone- ja Time-arvojen vakiomuotomäärite.

Päivämäärämuodot

Ryhmä sisältää seuraavat muodot:

Lyhyt päivämäärämuotomäärite ("d")

"d"-vakiomuotomäärite edustaa mukautettua päivämäärämuotoa, joka on määritetty tietyllä maa-toiminnolla. Esimerkiksi muuttumattoman maa-asetuksen palauttama mukautettu muotoiluteksti on "KK/pp/vvvv".

Seuraavassa esimerkissä näytetään päivämääräarvo d-muotomääriteen avulla.

let
    Source =
    {
        Date.ToText(#date(2024, 4, 10), [Format = "d", Culture = ""]),
        // Displays 04/10/2024

        Date.ToText(#date(2024, 4, 10), [Format = "d", Culture = "en-US"]),
        // Displays 4/10/2024

        Date.ToText(#date(2024, 4, 10), [Format = "d", Culture = "en-NZ"]),
        // Displays 10/4/2024

        Date.ToText(#date(2024, 4, 10), [Format = "d", Culture = "de-DE"])
        // Displays 10.4.2024
    }
in
    Source

Takaisin taulukkoon

Pitkä päivämäärä ("D") -muodon määrite

"D"-vakiomuotomäärite edustaa mukautettua päivämäärämuotoa, joka on määritetty tietyllä maa-toiminnolla. Esimerkiksi muuttumattoman maa-asetuksen mukautettu muotoilumerkkijono on "pppp, ppKKKK vvvv".

Seuraavassa esimerkissä näytetään päivämäärä- ja aika-arvo D-muotomääriteen avulla.

let
    Source =
    {
        Date.ToText(#date(2024, 4, 10), [Format = "D", Culture = ""]),
        // Displays Wednesday, 10 April, 2024

        Date.ToText(#date(2024, 4, 10), [Format = "D", Culture = "en-US"]),
        // Displays Wednesday, April 10, 2024

        Date.ToText(#date(2024, 4, 10), [Format = "D", Culture = "pt-BR"]),
        // Displays quarta-feira, 10 de abril de 2024

        Date.ToText(#date(2024, 4, 10), [Format = "D", Culture = "es-MX"])
        // Displays miércoles, 10 de abril de 2024
    }
in
    Source

Takaisin taulukkoon

Päivämäärän ja kellonajan muodot

Ryhmä sisältää seuraavat muodot:

Koko päivämäärän lyhyt aika ("f") -muodon määrite

"f"-vakiomuotomäärite edustaa pitkän päivämäärän ("D") ja lyhyen ajan ("t") mallien yhdistelmää välilyönnillä eroteltuna.

Tietyn maa-asetuksen muotoilutiedot vaikuttavat tulosmerkkijonoon.

Seuraavassa esimerkissä näytetään päivämäärä- ja aika-arvo f-muodon määritteen avulla.

let
    Source =
    {
        DateTime.ToText(#datetime(2024, 4, 10, 6, 30, 0), [Format = "f", Culture = "en-US"]),
        // Displays Wednesday, April 10, 2024 6:30 AM

        DateTime.ToText(#datetime(2024, 4, 10, 6, 30, 0), [Format = "f", Culture = "fr-FR"])
        // Displays mercredi 10 avril 2024 06:30
    }
in
    Source

Takaisin taulukkoon

Koko päivämäärän pitkä aika ("F") -muodon määrite

F-vakiomuotomäärite edustaa mukautettua päivämäärän ja kellonajan muotoa, joka on määritetty tietyllä maa-toiminnolla. Esimerkiksi muuttumattoman maa-asetuksen mukautettu muotoilumerkkijono on "pppp, ppKKKK VVVV HH:mm:ss".

Tietyn maa-asetuksen muotoilutiedot vaikuttavat tulosmerkkijonoon.

Seuraavassa esimerkissä näytetään päivämäärä- ja aika-arvo F-muodon määritteen avulla.

let
    Source =
    {
        DateTime.ToText(#datetime(2024, 4, 10, 6, 30, 0), [Format = "F", Culture = ""]),
        // Displays Wednesday, 10 April, 2024 06:30:00

        DateTime.ToText(#datetime(2024, 4, 10, 6, 30, 0), [Format = "F", Culture = "en-US"]),
        // Displays Wednesday, April 10, 2024 6:30:00 AM

        DateTime.ToText(#datetime(2024, 4, 10, 6, 30, 0), [Format = "F", Culture = "fr-FR"])
        // Displays mercredi 10 avril 2024 06:30:00
    }
in
    Source

Takaisin taulukkoon

Yleinen päivämäärän lyhyt kellonaika ("g") -muodon määrite

"g"-vakiomuotomäärite edustaa lyhyen päivämäärän ("d") ja lyhyen ajan ("t") mallien yhdistelmää välilyönnillä eroteltuna. Tietyn maa-asetuksen muotoilutiedot vaikuttavat tuloksena saatavaan tekstiin.

Tietyn maa-asetuksen muotoilutiedot vaikuttavat tulosmerkkijonoon.

Seuraavassa esimerkissä näytetään päivämäärä- ja aika-arvo g-muodon määritteen avulla.

let
    Source =
    {
        DateTime.ToText(#datetime(2024, 4, 10, 6, 30, 0), [Format = "g", Culture = ""]),
        // Displays 04/10/2024 06:30

        DateTime.ToText(#datetime(2024, 4, 10, 6, 30, 0), [Format = "g", Culture = "en-US"]),
        // Displays 4/10/2024 6:30 AM

        DateTime.ToText(#datetime(2024, 4, 10, 6, 30, 0), [Format = "g", Culture = "fr-BE"])
        // Displays 10-04-24 06:30
    }
in
    Source

Takaisin taulukkoon

Yleinen päivämäärän pitkä aika ("G") -muodon määrite

G-vakiomuotomäärite edustaa lyhyen päivämäärän ("d") ja pitkän ajan ("T") mallien yhdistelmää välilyönnillä eroteltuna. Tietyn maa-asetuksen muotoilutiedot vaikuttavat tuloksena saatavaan tekstiin.

Tietyn maa-asetuksen muotoilutiedot vaikuttavat tulosmerkkijonoon.

Seuraavassa esimerkissä näytetään päivämäärä- ja aika-arvo G-muodon määritteen avulla.

let
    Source =
    {
        DateTime.ToText(#datetime(2024, 4, 10, 6, 30, 0), [Format = "G", Culture = ""]),
        // Displays 04/10/2024 06:30:00

        DateTime.ToText(#datetime(2024, 4, 10, 6, 30, 0), [Format = "G", Culture = "en-US"]),
        // Displays 4/10/2024 6:30:00 AM

        DateTime.ToText(#datetime(2024, 4, 10, 6, 30, 0), [Format = "G", Culture = "nl-BE"])
        // Displays 10/04/2024 6:30:00
    }
in
    Source

Takaisin taulukkoon

Kierto-muodon ("O", "o") määritys

O- tai o-vakiomuotomäärite edustaa mukautettua päivämäärän ja kellonajan muotoilun merkkijonoa. Sen avulla käytetään mallia, jossa aikavyöhyketiedot säilytetään ja tulosmerkkijono vastaa ISO-standardia 8601. DateTimeZone-arvoille tämä muotomäärite on suunniteltu päivämäärä-, aika- ja aikavyöhykearvojen säilyttämiseen tekstissä.

"O"- tai "o"-vakiomuotomäärite vastaa "yyyy'--'MM''dd'T'HH':'mm':'ss'.". fffffffxxx" mukautettu muotoilumerkkijono DateTimeZone-arvoille. Tässä tekstissä heittomerkkien, jotka erottavat yksittäisiä merkkejä, kuten yhdysmerkkejä, kaksoispisteitä ja kirjainta "T", parit ilmaisevat, että yksittäinen merkki on literaali, jota ei voi muuttaa. Heittomerkkejä ei näytetä tulosmerkkijonossa.

"O" tai "o" vakiomuodon määrite (ja "yyyy'-'MM''dd'T'HH':''mm':'ss'.". fffffffxxx" mukautettu muoto) hyödyntää tapoja, joilla ISO 8601 edustaa aikavyöhyketietoja DateTimeZone- arvojen säilyttämiseksi:

  • DateTimeZone.ToLocal päivämäärä- ja aika-arvojen aikavyöhykeosa on siirtymä UTC-arvosta (esimerkiksi +01:00, -07:00).

  • DateTimeZone.ToUtc päivämäärä- ja aika-arvojen aikavyöhykeosa esittää UTC-arvoa +00,00.

Koska "O"- tai "o"-vakiomuotomäärite on kansainvälisen standardin mukainen, määritettä käyttävä muotoilu- tai jäsennystoiminto käyttää aina muuttumattomuutta maa-asetusta ja gregoriaanista kalenteria.

Seuraavassa esimerkissä "o"-muotomääritettä käytetään näyttämään päivämäärä-, aika- ja aikavyöhykearvojen sarja järjestelmässä Yhdysvaltain Tyynenmeren aikavyöhykkeellä.

let
    date1 = #datetimezone(2024, 6, 15, 13, 45, 30, 0, 0),
    Source =
    {
        Text.Format("#{0} (Unspecified) --> #{1}", {date1, DateTimeZone.ToText(date1, [Format = "O"])}),
        Text.Format("#{0} (Utc) --> #{1}", {date1, DateTimeZone.ToText(DateTimeZone.ToUtc(date1), [Format = "O"])}),
        Text.Format("#{0} (Local) --> #{1}", {date1, DateTimeZone.ToText(DateTimeZone.ToLocal(date1), [Format = "O"])})
    }
in
    Source

// The example displays the following output:
//    6/15/2024 1:45:30 PM +00:00 (Unspecified) --> 2024-06-15T13:45:30.0000000+00:00
//    6/15/2024 1:45:30 PM +00:00 (Utc) --> 2024-06-15T13:45:30.0000000+00:00
//    6/15/2024 1:45:30 PM +00:00 (Local) --> 2024-06-15T08:45:30.0000000-07:00

Muistiinpano

DateTimeZone.ToLocal 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 palauttaa -07:00paikallisen ajan, koska se lukee paikallisessa koneessasi 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.

Seuraavassa esimerkissä luodaan muotoillun merkkijonon "o"-muodon määritteellä ja palautetaan sitten alkuperäinen päivämäärä- ja aika-arvo kutsumalla päivämäärän ja ajan jäsennysrutiinia.

let
    // Round-trip a local time
    #"Origin Local Date" = DateTimeZone.ToLocal(
        #datetimezone(2024, 4, 10, 6, 30, 0, 0, 0)
    ),
    #"Local Date Text" = DateTimeZone.ToText(
        #"Origin Local Date", [Format = "o"]
    ),
    #"New Local Date" = DateTimeZone.FromText(#"Local Date Text"),
    #"Local Round Trip" = Text.Format(
        "Round-tripped #{0} Local to #{1} Local.", 
        {
            DateTimeZone.ToText(#"Origin Local Date"), 
            DateTimeZone.ToText(#"New Local Date")
        }
    ),

    // Round-trip a UTC time
    #"Origin UTC Date" = DateTimeZone.ToUtc(
        #datetimezone(2024, 4, 12, 9, 30, 0, 0, 0)
    ),
    #"UTC Date Text" = DateTimeZone.ToText(
        #"Origin UTC Date", [Format = "o"]
    ),
    #"New UTC Date" = DateTimeZone.FromText(#"UTC Date Text"),
    #"UTC Round Trip" = Text.Format(
        "Round-tripped #{0} UTC to #{1} UTC.", 
        {
            DateTimeZone.ToText(#"Origin UTC Date"), 
            DateTimeZone.ToText(#"New UTC Date")
        }
    ),

    // Round-trip an 18 hour offset time
    #"Origin Offset Date" = DateTimeZone.ToLocal(
        #datetimezone(2024, 4, 10, 6, 30, 0, 0, 0) + #duration(0, 18, 0, 0)
    ),
    #"Offset Date Text" = DateTimeZone.ToText(
        #"Origin Offset Date", [Format = "o"]
    ),
    #"New Offset Date" = DateTimeZone.FromText(#"Offset Date Text"),
    #"Offset Round Trip" = Text.Format(
        "Round-tripped #{0} to #{1}.", 
        {
            DateTimeZone.ToText(#"Origin Offset Date"), 
            DateTimeZone.ToText(#"New Offset Date")
        }
    ),

    #"Round Trip Results" = 
        {#"Local Round Trip", #"UTC Round Trip", #"Offset Round Trip"}
in
    #"Round Trip Results"

// The example displays the following output in Power Query Desktop:
//    Round-tripped 4/9/2024 11:30:00 PM -07:00 Local to 4/9/2024 11:30:00 PM -07:00 Local.
//    Round-tripped 4/12/2024 9:30:00 AM +00:00 UTC to 4/12/2024 9:30:00 AM +00:00 UTC.
//    Round-tripped 4/10/2024 5:30:00 PM -07:00 to 4/10/2024 5:30:00 PM -07:00.

// The example displays the following output in Power Query Online:
//    Round-tripped 4/10/2024 6:30:00 AM +00:00 Local to 4/10/2024 6:30:00 AM +00:00 Local.
//    Round-tripped 4/12/2024 9:30:00 AM +00:00 UTC to 4/12/2024 9:30:00 AM +00:00 UTC.
//    Round-tripped 4/11/2024 12:30:00 AM +00:00 to 4/11/2024 12:30:00 AM +00:00.

Takaisin taulukkoon

RFC1123 ("R", "r") -muodon määrite

R- tai r-vakiomuotomäärite edustaa mukautettua päivämäärän ja ajan muotoilun merkkijonoa, jota tietty maa-asetus ei määritä. Se on aina sama riippumatta käytetystä maa-a tai muotoilupalvelusta. Mukautettu muotoilumerkkijono on "ddd, dd MMM yyyy HH':'mm':'ss 'GMT'". Kun tätä vakiomuotomääritettä käytetään, muotoilu- tai jäsennystoiminnossa käytetään aina muuttumattoman maa-asetuksen arvoa.

Vaikka RFC 1123 -standardi ilmaisee ajan koordinoituna yleisaikana (UTC), muotoilutoiminto ei muuta muotoillun päivämäärän ja ajan arvoa. Siksi datetime-arvo on muunnettava UTC-arvoksi kutsumalla DateTimeZone.ToUtc-funktiomenetelmää, ennen kuin suoritat muotoilutoiminnon.

Seuraavassa esimerkissä käytetään "r"-muotomääritettä näyttämään aika- ja päivämääräarvo järjestelmässä Yhdysvaltain Tyynenmeren aikavyöhykkeellä (seitsemän tuntia UTC-aikaa jäljessä).

let
    date1 = #datetimezone(2024, 4, 10, 6, 30, 0, -7, 0),
    dateOffset = DateTimeZone.ToUtc(date1),
    Source = 
    {
        DateTimeZone.ToText(date1, [Format = "r"]),
        // Displays Wed, 10 Apr 2024 13:30:00 GMT

        DateTimeZone.ToText(dateOffset, [Format = "r"])
        // Displays Wed, 10 Apr 2024 13:30:00 GMT
    }
in
    Source

Takaisin taulukkoon

Lajiteltavan muodon määrite

"s"-vakiomuotomäärite edustaa mukautettua päivämäärän ja kellonajan muotoilun merkkijonoa, joka kuvastaa määritettyä standardia (ISO 8601), ja on vain luku -muodossa. Näin ollen asetus on aina sama riippumatta käytetystä maa-a tai annetusta muotoilupalvelusta. Mukautettu muotoilumerkkijono on "yyyy'-'MM'-'dd'T'HH':'mm':'ss". S-muodon määritteen tarkoituksena on tuottaa tulosmerkkijonoja, jotka lajitellaan johdonmukaisesti nousevassa tai laskevassa järjestyksessä päivämäärä- ja aika-arvojen perusteella.

Kun tätä vakiomuotomääritettä käytetään, muotoilu- tai jäsennystoiminnossa käytetään aina muuttumattoman maa-asetuksen arvoa.

Seuraavassa esimerkissä käytetään "s"-muotomääritettä päivämäärä- ja aika-arvon näyttämiseen järjestelmässä Yhdysvaltain Tyynenmeren aikavyöhykkeellä.

let
    Source =
    {
        DateTime.ToText(#datetime(2024, 4, 10, 6, 30, 0), [Format = "s", Culture = "en-US"])
        // Displays 2024-04-10T06:30:00
    }
in
    Source

Takaisin taulukkoon

Yleinen lajittelumuoto ("u") -määrite

u-vakiomuotomäärite edustaa mukautettua päivämäärän ja kellonajan muotoilumerkkijonoa, joka on aina sama käytetystä maa-asettelusta tai annetusta muotoilupalvelusta riippumatta. Mukautettu muotoilumerkkijono on "yyyy'-'MM'-'dd HH':'mm':'ss'Z'". Malli kuvastaa määritettyä standardia ja ominaisuus on vain luku -tilassa. Kun tätä vakiomuotomääritettä käytetään, muotoilu- tai jäsennystoiminnossa käytetään aina muuttumattoman maa-asetuksen arvoa.

Vaikka tulosmerkkijonon tulisi ilmaista aika muodossa Koordinoitu yleisaika (UTC), alkuperäistä DateTimeZone-arvoa ei muunneta muotoilutoiminnon aikana. Siksi sinun on muunnettava DateTimeZone--arvo UTC-arvoksi kutsumalla DateTimeZone.ToUtc funktiota ennen sen muotoilua.

Seuraavassa esimerkissä näytetään päivämäärä- ja aika-arvo u-muodon määritteen avulla.

let
    date1 = #datetimezone(2024, 4, 10, 6, 30, 0, -7, 0),
    dateOffset = DateTimeZone.ToUtc(date1),
    Source =
    {
        DateTimeZone.ToText(dateOffset, [Format = "u"]),
        // Displays 2024-04-10 13:30:00Z
    }
in
    Source

Takaisin taulukkoon

Aikamuodot

Ryhmä sisältää seuraavat muodot:

Lyhyen ajan ("t") muodon määrite

"t"-vakiomuotomäärite edustaa mukautettua päivämäärän ja kellonajan muotoilun merkkijonoa, jonka määritetty maa-asetus määrittää. Esimerkiksi muuttumattoman maa-asetuksen mukautettu muotoilumerkkijono on "HH:mm".

Tietyn maa-asetuksen muotoilutiedot vaikuttavat tulosmerkkijonoon.

Seuraavassa esimerkissä näytetään päivämäärä- ja aika-arvo t-muodon määritteen avulla.

let
    Source =
    {
        DateTime.ToText(#datetime(2024, 4, 10, 6, 30, 0), [Format = "t", Culture = ""]),
        // Displays 06:30
        
        DateTime.ToText(#datetime(2024, 4, 10, 6, 30, 0), [Format = "t", Culture = "en-US"]),
        // Displays 6:30 AM

        DateTime.ToText(#datetime(2024, 4, 10, 6, 30, 0), [Format = "t", Culture = "es-ES"])
        // Displays 6:30
    }
in
    Source

Takaisin taulukkoon

Pitkän ajan ("T") muodon määrite

T-vakiomuotomäärite edustaa mukautettua päivämäärän ja kellonajan muotoilun merkkijonoa, jonka tietty maa-asetus määrittää. Esimerkiksi muuttumattoman maa-asetuksen mukautettu muotoilumerkkijono on "HH:mm:ss".

Seuraavassa esimerkissä näytetään päivämäärä- ja aika-arvo T-muodon määritteen avulla.

let
    Source =
    {
        DateTime.ToText(#datetime(2024, 4, 10, 6, 30, 0), [Format = "T", Culture = ""]),
        // Displays 06:30:00
        
        DateTime.ToText(#datetime(2024, 4, 10, 6, 30, 0), [Format = "T", Culture = "en-US"]),
        // Displays 6:30:00 AM

        DateTime.ToText(#datetime(2024, 4, 10, 6, 30, 0), [Format = "T", Culture = "es-ES"])
        // Displays 6:30:00
    }
in
    Source

Takaisin taulukkoon

Osittaiset päivämäärämuodot

Ryhmä sisältää seuraavat muodot:

Kuukauden ("M", "m") muodon määrite

"M"- tai "m"-vakiomuotomäärite edustaa mukautettua päivämäärän ja kellonajan muotoilun merkkijonoa, jonka tietty maa-asetus määrittää. Esimerkiksi muuttumattoman maa-asetuksen mukautettu muotoilumerkkijono on "MMMM pp".

Seuraavassa esimerkissä näytetään päivämäärä- ja aika-arvo m-muodon määritteen avulla.

let
    Source =
    {
        DateTime.ToText(#datetime(2024, 4, 10, 6, 30, 0), [Format = "m", Culture = ""]),
        // Displays April 10
        
        DateTime.ToText(#datetime(2024, 4, 10, 6, 30, 0), [Format = "m", Culture = "en-US"]),
        // Displays April 10

        DateTime.ToText(#datetime(2024, 4, 10, 6, 30, 0), [Format = "m", Culture = "ms-MY"])
        // Displays 10 April
    }
in
    Source

Takaisin taulukkoon

Vuoden kuukauden ("Y", "y") muodon määrite

Y- tai y-vakiomuotomäärite edustaa mukautettua päivämäärämuotomerkkijonoa, jonka tietty maa-asetus määrittää. Esimerkiksi muuttumattoman maa-asetuksen mukautettu muotoilumerkkijono on "VVVV KKKK".

Seuraavassa esimerkissä näytetään päivämäärä- ja aika-arvo y-muodon määritteen avulla.

let
    Source =
    {
        DateTime.ToText(#datetime(2024, 4, 10, 6, 30, 0), [Format = "Y", Culture = ""]),
        // Displays 2024 April
        
        DateTime.ToText(#datetime(2024, 4, 10, 6, 30, 0), [Format = "Y", Culture = "en-US"]),
        // Displays April 2024

        DateTime.ToText(#datetime(2024, 4, 10, 6, 30, 0), [Format = "y", Culture = "af-ZA"])
        // Displays April 2024
    }
in
    Source

Takaisin taulukkoon

Liittyvä sisältö