ER-funktionen DATETIMEFORMAT
Funktionen DATETIMEFORMAT returnerer en Streng-værdi, som præsenterer en given dato-/klokkeslætsværdi som tekst i det angivne format og i en eventuelt angivet kultur. Oplysninger om understøttede formater finder du under standard og brugerdefineret.
Syntaks 1
DATETIMEFORMAT (datetime, format)
Syntaks 2
DATETIMEFORMAT (datetime, format, culture)
Argumenter
datetime: DateTime
En dato-/klokkeslætsværdi, der repræsenterer den dato og det klokkeslæt, der skal formateres.
format: Streng
Outputstrengens format. Oplysninger om understøttede formater finder du under standard og brugerdefineret.
Bemærk!
Der skelnes mellem store og små bogstaver i formatstrengen, når du enten bruger et standardformat eller et brugerdefineret format. F.eks. returnerer standardformatet "d" datoen ved at bruge det korte datomønster, mens standardformatet "D" returnerer datoen ved at bruge det lange datomønster. Desuden returnerer det brugerdefinerede "M"-format måneden fra 1 til 12, mens det brugerdefinerede "m"-format returnerer minuttallet fra 0 til og med 59.
culture: Streng
Den kultur, du vil bruge til formatering. Du kan finde oplysninger om de understøttede kulturer under kultur.
Returnerede værdier
Streng
Den resulterende strengværdi.
Bemærkninger til brug
Hvis kulturen ikke er defineret som et argument for den kaldte funktion, er værdien af culture defineret af den kaldende kontekst. For eksempel, hvis funktionen DATETIMEFORMAT kaldes ved hjælp af syntaks 1 i et elektronisk rapporteringsformat (ER) for et FIL-element, der er konfigureret til at bruge den tyske kultur, vil konverteringen ske ved hjælp af den tyske kultur. Standardværdien for culture er EN-US.
Når funktionen DATETIMEFORMAT konverterer en given dato-/klokkeslætsværdi, tages den tidszoneindstillingen for den programbruger, der kører ER-formatet, som funktionen kaldes i sammenhæng med i betragtning.
Eksempel 1
DATETIMEFORMAT (NOW(), "dd-MM-yyyy") returnerer den aktuelle dato-/klokkeslætsværdi på programserveren, 24. december 2015, som "24-12-2015", baseret på det angivne brugerdefinerede format.
Eksempel 2
DATETIMEFORMAT (SESSIONNOW(), "d", "DE") returnerer datoen/klokkeslættet for den aktuelle programsession, 24. december 2015, som strengen "24.12.2015", baseret på den valgte tyske kultur og det angivne format.
Eksempel 3
DATETIMEFORMAT (DATETIMEVALUE( "2019-11-12T09:00:00.0000000-07:00", "O"), "O") returnerer strengværdien 2019-11-12T08:00:00.0000000-08:00, når funktionen kaldes under en proces, der blev initieret af en programbruger, der har tidszoneværdien (GMT-08:00) Pacific Time (USA og Canada) i afsnittet Sprog og land/område-præferencer.