De ER-functie DATETIMEFORMAT

De functie DATETIMEFORMAT retourneert een waarde van het type Tekenreeks voor een bepaalde datum-/tijdwaarde als tekst in de opgegeven indeling en in een optioneel opgegeven cultuur. Zie voor informatie over de ondersteunde indelingen standaard en aangepast.

Syntaxis 1

DATETIMEFORMAT (datetime, format)

Syntaxis 2

DATETIMEFORMAT (datetime, format, culture)

Argumenten

datetime: Datum/tijd

Een datum-/tijdwaarde die de datum- en tijdnotatie aangeeft.

format: Tekenreeks

De indeling van de uitvoertekenreeks. Zie voor informatie over de ondersteunde indelingen standaard en aangepast.

Notitie

De notatietekenreeks is hoofdlettergevoelig wanneer u een standaardnotatie of een aangepaste notatie gebruikt. De standaard specificatie voor de notatie "d" bijvoorbeeld retourneert de datum met het patroon voor een korte datum, terwijl de standaard specificatie voor de notatie "D" de datum retourneert met het patroon voor de lange datum. Verder retourneert de aangepaste specificatie voor de notatie "M" de maand van 1 t/m 12, terwijl de aangepaste specificatie voor de notatie "m" de minuut van 0 t/m 59 retourneert.

culture: Tekenreeks

De cultuur die moet worden gebruikt voor de indeling. Voor meer informatie over de ondersteunde culturen zie cultuur.

Retourwaarden

Tekenreeks

De resulterende tekenreekswaarde.

Gebruiksaanwijzingen

Wanneer de cultuur niet is gedefinieerd als een argument van de aangeroepen functie, wordt de waarde van culture gedefinieerd door de aanroepcontext. Als de functie DATETIMEFORMAT bijvoorbeeld wordt aangeroepen met syntaxis 1 in een ER-indeling (Elektronische rapportage) voor een element FILE dat is geconfigureerd voor gebruik van de Duitse cultuur, wordt de conversie uitgevoerd met de Duitse cultuur. De standaardwaarde van culture is EN-US.

Wanneer de functie DATETIMEFORMAT een bepaalde datum-/tijdwaarde converteert, wordt rekening gehouden met de tijdzone-instelling van de toepassingsgebruiker die de ER-indeling uitvoert waarin de functie wordt aangeroepen.

Voorbeeld 1

DATETIMEFORMAT (NOW(), "dd-MM-yyyy") retourneert de datum/tijd van de huidige toepassingsserver, 24 december 2015, als 24-12-2015, op basis van de opgegeven aangepaste notatie.

Voorbeeld 2

DATETIMEFORMAT (SESSIONNOW(), "d", "DE") retourneert de huidige sessiedatum/-tijd van de toepassing, 24 december 2015, als 24.12.2015, op basis van de geselecteerde Duitse cultuur en de opgegeven notatie.

Voorbeeld 3

DATETIMEFORMAT (DATETIMEVALUE( "2019-11-12T09:00:00.0000000-07:00", "O"), "O") retourneert de tekenreekswaarde 2019-11-12T08:00:00.0000000-08:00 wanneer de functie wordt aangeroepen tijdens een proces dat is geïnitieerd door een toepassingsgebruiker met de tijdzonewaarde (GMT-08:00) Pacific Time (VS en Canada) in de sectie Voorkeuren voor taal en land/regio.

Aanvullende resources

Datum- en tijdfuncties