DATETIMEFORMAT ER-funksjonen
DATETIMEFORMAT-funksjonen returnerer en Streng-verdi som viser en gitt dato/klokkeslett-verdi som tekst i angitt format og i en valgfri angitt kultur. Hvis du vil ha informasjon om hvilke formater som støttes, kan du se standard og egendefinert.
Syntaks 1
DATETIMEFORMAT (datetime, format)
Syntaks 2
DATETIMEFORMAT (datetime, format, culture)
Argumenter
datetime: DateTime
En dato/klokkeslett-verdi som representerer dato og klokkeslett til-formatet.
format: Streng
Formatet til utdatastrengen. Hvis du vil ha informasjon om hvilke formater som støttes, kan du se standard og egendefinert.
Notat
Det skilles mellom små og store bokstaver i formatstrengen når du bruker et standardformat eller et egendefinert format. Den standard formatangivelsen «d» returnerer for eksempel datoen ved hjelp av det korte datomønsteret, mens den standard formatangivelsen «D» returnerer ved hjelp av mønsteret med lang dato. Den egendefinerte formatangivelsen «M» returnerer måneden fra 1 til og med 12, mens den egendefinerte formatangivelsen «m» returnerer minuttet fra 0 til og med 59.
culture: Streng
Kulturen som skal brukes til formatering. Hvis du vil ha informasjon om de støttede språkene, kan du se kultur.
Returverdier
Streng
Den resulterende strengverdien.
Bruksnotater
Hvis kulturen ikke er definert som et argument for den kalte funksjonen, defineres verdien for culture av kallekonteksten. Hvis DATETIMEFORMAT-funksjonen for eksempel kalles ved hjelp av syntaks 1 i et ER-format for et FIL-element som er konfigurert til å bruke tysk kultur, vil konverteringen gjøres ved hjelp av tysk kultur. Standardverdi for culture er EN-US.
Når DATETIMEFORMAT-funksjonen konverterer en gitt dato/klokkeslett-verdi, vurderes innstillingen for tidssone for programbrukeren som kjører ER-formatet som funksjonen kalles i konteksten til.
Eksempel 1
DATETIMEFORMAT (NOW(), "dd-MM-yyyy") returnerer gjeldende dato/klokkeslett-verdi for programserveren, 24. desember 2015, som "24-12-2015", basert på det angitte egendefinerte formatet.
Eksempel 2
DATETIMEFORMAT (SESSIONNOW(), "d", "DE") returnerer gjeldende dato/klokkeslett-verdi for programøkt, 24. desember 2015, som "24.12.2015", basert på den valgte tyske kulturen og det angitte formatet.
Eksempel 3
DATETIMEFORMAT (DATETIMEVALUE( "2019-11-12T09:00:00.0000000-07:00", "O"), "O") returnerer strengverdien 2019-11-12T 08:00:00.0000000-08:00 når funksjonen kalles under en prosess som ble startet av en programbruker som har tidssoneverdien (GMT-08:00) Stillehavskysten (USA og Canada) i delen Innstillinger for språk og land/område.