Fonction DATETIMEVALUE ER
La fonction DATETIMEVALUE renvoie une valeur DateTime qui est convertie à partir d’une valeur de texte donnée dans le format spécifié et dans une culture spécifiée en option sur une valeur de date/heure. Pour plus d’informations sur les formats pris en charge, consultez standard et personnalisé.
Syntaxe 1
DATETIMEVALUE (text, format)
Syntaxe 2
DATETIMEVALUE (text, format, culture)
Arguments
text: Chaîne
Texte qui représente la valeur à mettre en forme.
format : Chaîne
Format du texte donné. Pour plus d’informations sur les formats pris en charge, consultez standard et personnalisé.
culture : Chaîne
Culture utilisée pour la mise en forme du texte donné. Pour plus d’informations sur les cultures prises en charge, voir culture.
Valeurs de retour
Date et heure
Valeur de date/heure résultante.
Notes d’utilisation
Lorsque la culture n’est pas définie comme un argument de la fonction appelée, la valeur de culture est définie par le contexte d’appel. Par exemple, si la fonction DATETIMEVALUE est appelée en utilisant la syntaxe 1 dans un format d’états électroniques (ER) pour un élément FILE configuré pour utiliser la culture allemande, la conversion se fera en utilisant la culture allemande. La valeur culture par défaut est EN-US.
Exemple 1
DATETIMEVALUE ("21-Dec-2016 02:55:00", "dd-MMM-yyyy hh:mm:ss") renvoie 2:55:00 AM le 21 décembre 2016, en fonction du format personnalisé spécifié et de la culture EN-US de l’application par défaut.
Exemple 2
DATETIMEVALUE ("21-Gen-2016 02:55:00", "dd-MMM-yyyy hh:mm:ss", "IT") renvoie 2:55:00 AM le 21 décembre 2016, en fonction du format et de la culture personnalisés spécifiés.
Toutefois, DATETIMEVALUE ("21-Gen-2016 02:55:00", "dd-MMM-yyyy hh:mm:ss", "EN-US") lève une exception pour informer l’utilisateur que la chaîne spécifiée n’est pas identifiée comme une date/heure valide pour la culture spécifiée.