Funktionen DATETIMEFORMAT ER

Funktionen DATETIMEFORMAT returnerar ett värde för Sträng som visar ett givet datum/tidsvärde som text i angivet format och i en valfri angiven kultur. Om du vill ha mer information om format som stöds, se Standard och Anpassat.

Syntax 1

DATETIMEFORMAT (datetime, format)

Syntax 2

DATETIMEFORMAT (datetime, format, culture)

Argument

datetime: DateTime

Ett datum-/tidsvärde som representerar det datum och den tid som ska formateras.

format: Sträng

Formatet på utdatasträngen Om du vill ha mer information om format som stöds, se Standard och Anpassat.

Notering

Formatsträngen är skiftlägeskänslig när du använder antingen ett standardformat eller ett anpassat format. Till exempel standard "d" formatspecificeraren returnerar datumet med hjälp av det korta datummönstret, medan standard "D" formatspecificeraren returnerar datumet med hjälp av det långa datummönstret. Dessutom returnerar den anpassade "M" formatspecificeraren månaden från 1 till 12, medan den anpassade "m" formatspecificeraren returnerar minuten från 0 till 59.

culture: Sträng

Kulturen som ska användas för formatering. För information om de kulturer som stöds, se kultur.

Returvärden

Sträng

Det resulterande strängvärdet.

Användningsanteckningar

När kulturen inte definieras som ett argument för den anropade funktionen definieras värdet av culture den anropande kontexten. Om till exempel funktionen DATETIMEFORMAT anropas med syntax 1 i ett format för elektronisk rapportering (ER) för ett FIL-element som är konfigurerat för att använda den tyska kulturen, sker konverteringen med hjälp av den tyska kulturen. Standardvärdet culture är EN-US.

När DATETIMEFORMAT-funktionen konverterar ett givet datum/tidsvärde, beaktar den tidszonsinställningen för den programanvändare som kör det ER-format som funktionen anropas i kontexten för.

Exempel 1

DATETIMEFORMAT (NOW(), "dd-MM-yyyy") returnerar det aktuella datum/tidsvärdet för serverprogrammet 24 december 2015, som strängen "2015-12-24", baserat på det definierade och anpassade formatet.

Exempel 2

DATETIMEFORMAT (SESSIONNOW(), "d", "DE") returnerar det aktuella datumet för programsessionen/tidsvärde, 24 december 2015 som "2015-12-24", baserat på den valda tyska kulturen och det angivna formatet.

Exempel 3

DATETIMEFORMAT (DATETIMEVALUE( "2019-11-12T09:00:00.0000000-07:00", "O"), "O") returnerar strängvärdet 2019-11-12T08:00:00.0000000-08:00 när funktionen anropas under en process som initierades av en programanvändare som har tidszonsvärde (GMT-08:00) Pacific Time (USA & Kanada) i avsnittet Språk och land/regionpreferenser.

Ytterligare resurser

Datum- och tidsfunktioner