DATETIMEFORMAT ER-funktio
DATETIMEFORMAT-funktio palauttaa Merkkijonoarvon, joka esittää tietyn päivämäärä-/aika-arvon tekstinä määritetyssä muodossa ja valinnaisesti määritetyssä kulttuurissa. Lisätietoja tuetuista muodoista on kohdassa vakio ja mukautettu.
Syntaksi 1
DATETIMEFORMAT (datetime, format)
Syntaksi 2
DATETIMEFORMAT (datetime, format, culture)
Argumentit
datetime: Päivämäärä/aika
Päivämäärä-/aika-arvo, joka vastaa muokattavaa päivämäärää ja aikaa.
format: Merkkijono
Tulostusmerkkijonon muoto Lisätietoja tuetuista muodoista on kohdassa vakio ja mukautettu.
Muistiinpano
Muodon merkkijono ottaa kirjainkoon huomioon, kun käytössä joko vakiomuoto tai mukautettu muoto. Esimerkiksi vakiomuotoinen d-määrite palauttaa päivämäärän käyttämällä lyhyt päivämäärämalli, kun taas vakiomuotoinen D-määrite palauttaa pitkää päivämäärämallia käyttävän päivämäärän. Lisäksi mukautetun muodon M-määrite palauttaa kuukaudet 1–12, kun taas mukautetun muodon m-määrite palauttaa minuutit 0–59.
culture: Merkkijono
Muotoilussa käytettävä kulttuuri. Lisätietoja tuetuista kulttuureista on kohdassa kulttuuri.
Palautusarvot
Merkkijono
Tuloksena oleva merkkijonoarvo.
Käyttöhuomautukset
Jos kulttuuria ei ole määritetty kutsutun funktion argumentiksi, kutsuvan kontekstin määrittämä arvo culture määritetään. Jos DATETIMEFORMAT-funktiota kutsutaan esimerkiksi käyttämällä syntaksia 1 sähköisen raportoinnin (ER) muodossa TIEDOSTO-elementille, joka on määritetty käyttämään Saksan kulttuuria, muuntaminen tehdään Saksan kulttuurin avulla. culture-arvon oletusarvo on FI-FI.
Kun DATETIMEFORMAT-funktio muuntaa tietyn päivämäärä- ja aika-arvon, se harkitsee sen sovelluksen käyttäjän aikavyöhykeasetusta, joka suorittaa ER-muotoa ja jota funktiota kutsutaan järjestelmän kontekstissa.
Esimerkki 1
DATETIMEFORMAT (NOW(), "dd-MM-yyyy") palauttaa nykyisen sovelluspalvelimen päivämäärä-/aika-arvon 24. joulukuuta 2015 muodossa 24-12-2015 määritetyn mukautetun muodon mukaisesti.
Esimerkki 2
DATETIMEFORMAT (SESSIONNOW(), "d", "DE") palauttaa nykyisen sovellusistunnon päivämäärä-/aika-arvon, 24. joulukuuta 2015, merkkijonona "24.12.2015", joka perustuu valittuun Saksan kulttuuriin ja määritettyyn muotoon.
Esimerkki 3
DATETIMEFORMAT (DATETIMEVALUE( "2019-11-12T09:00:00.0000000-07:00", "O"), "O") palauttaa merkkijonon arvon 2019-11-12T 08:00:00.0000000-08:00, kun funktiota kutsutaan prosessin aikana, jonka käynnistäneen sovelluskäyttäjän aikavyöhykkeen arvo on (GMT-08:00) Tyynenmeren normaaliaika (USA & Kanada)Kieli- ja alue-asetukset -osassa.