Fonction DATETIMEFORMAT ER

La fonction DATETIMEFORMAT renvoie une valeur de Chaîne qui présente une valeur de date/heure donnée dans le format spécifié et dans une culture éventuellement spécifiée. Pour plus d’informations sur les formats pris en charge, consultez standard et personnalisé.

Syntaxe 1

DATETIMEFORMAT (datetime, format)

Syntaxe 2

DATETIMEFORMAT (datetime, format, culture)

Arguments

datetime : DateHeure

Valeur de date/heure qui représente la date et l’heure à mettre en forme.

format : Chaîne

Format de la chaîne de sortie. Pour plus d’informations sur les formats pris en charge, consultez standard et personnalisé.

Note

La chaîne de format est sensible à la casse lorsque vous utilisez un format standard ou un format personnalisé. Par exemple, le spécificateur de format standard « d »renvoie la date à l’aide du schéma de date courte, tandis que le spécificateur de format standard « D » renvoie la date à l’aide du schéma de date longue. De plus, le spécificateur de format personnalisé « M » renvoie le mois de 1 à 12, tandis que le spécificateur de format personnalisé « m » renvoie les minutes de 0 à 59.

culture : Chaîne

Culture à utiliser pour la mise en forme. Pour plus d’informations sur les cultures prises en charge, voir culture.

Valeurs de retour

Chaîne

Valeur de la chaîne résultante.

Notes d’utilisation

Si 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 DATETIMEFORMAT 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.

Quand la fonction DATETIMEFORMAT convertit une valeur de date/heure donnée, elle considère le paramètre de fuseau horaire de l’utilisateur de l’application qui exécute le format ER que la fonction est appelée dans le contexte.

Exemple 1

DATETIMEFORMAT (NOW(), "dd-MM-yyyy") renvoie la valeur de date/heure du serveur d’applications actuelle, 24 décembre 2015, sous la forme « 24-12-2015 », en fonction du format personnalisé spécifié.

Exemple 2

DATETIMEFORMAT (SESSIONNOW(), "d", "DE") renvoie la valeur de date/heure de la session de l’application actuelle, 24 décembre 2015, sous la forme de « 24.12.2015 », en fonction de la culture allemande et du format sélectionnés spécifiés.

Exemple 3

DATETIMEFORMAT (DATETIMEVALUE( "2019-11-12T09:00:00.0000000-07:00", "O"), "O") renvoie la valeur de chaîne 2019-11-12T08:00:00.0000000-08:00 lorsqu’il est appelé lors d’un processus qui a été lancé par un utilisateur d’application qui a la valeur de fuseau horaire (GMT-08:00) Heure du Pacifique (États-Unis et Canada) dans la section Préférences de langue et paramètres locaux.

Ressources supplémentaires

Fonctions de date et d’heure