De ER-functie DATETIMEVALUE
De functie DATETIMEVALUE retourneert een waarde van het type DateTime die van een bepaalde tekstwaarde in de opgegeven indeling en in een optioneel opgegeven cultuur wordt geconverteerd naar een datum-/tijdwaarde. Zie voor informatie over de ondersteunde indelingen standaard en aangepast.
Syntaxis 1
DATETIMEVALUE (text, format)
Syntaxis 2
DATETIMEVALUE (text, format, culture)
Argumenten
text: Tekenreeks
Tekst die de in te delen waarde vertegenwoordigt.
format: Tekenreeks
De indeling van de betreffende tekst. Zie voor informatie over de ondersteunde indelingen standaard en aangepast.
culture: Tekenreeks
De cultuur die wordt gebruikt voor het indelen van de betreffende tekst. Voor meer informatie over de ondersteunde culturen zie cultuur.
Retourwaarden
DateTime
De resulterende datum-/tijdwaarde.
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 DATETIMEVALUE 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.
Voorbeeld 1
DATETIMEVALUE ("21-Dec-2016 02:55:00", "dd-MMM-yyyy hh:mm:ss") retourneert 2:55:00 AM op 21 december 2016 volgens de opgegeven aangepaste notatie en de cultuur EN-US van de standaardtoepassing.
Voorbeeld 2
DATETIMEVALUE ("21-Gen-2016 02:55:00", "dd-MMM-yyyy hh:mm:ss", "IT") retourneert 2:55:00 AM op 21 december 2016 volgens de opgegeven aangepaste notatie en de cultuur.
Echter, DATETIMEVALUE ("21-Gen-2016 02:55:00", "dd-MMM-yyyy hh:mm:ss", "EN-US") leidt tot een uitzondering en informeert de gebruiker dat de opgegeven tekenreeks niet als een geldige datum-/tijdwaarde wordt herkend voor de opgegeven cultuur.