Fonction UTOD( )

Convertit une chaîne de caractères Unicode contenant une date mise en forme en valeur date Analytics. Abréviation de "Unicode en Date".

Remarque

Cette fonction est spécifique à l'édition Unicode d'Analytics. Elle n'est pas prise en charge dans l'édition non-Unicode.

Utilisez cette fonction pour utiliser des dates dans des langues et formats différents de votre installation par défaut. Si la chaîne de caractères à convertir se trouve dans votre langue par défaut, utilisez CTOD( ) à la place.

Syntaxe

UTOD(chaîne_de_caractères <;paramètre> <;style>)

Paramètres

Nom Type Description
chaîne

caractère

La chaîne Unicode à convertir en date.

La chaîne Unicode peut contenir une valeur de type DateHeure, mais la portion de la valeur correspondant à l'heure sera ignorée. Les valeurs de temps seules ne sont pas prises en charge.

chaîne doit correspondre au format d'entrée requis par la valeur style pour les paramètres régionaux de la date.

paramètre

optionnel

caractère

Code indiquant la langue et les paramètres régionaux de la chaîne de sortie, et, de façon facultative, la version de la langue associée à un pays ou territoire particulier.

Par exemple, "zh" indique chinois, et "pt_BR" indique portugais brésilien.

Si vous ignorez ce paramètre, c'est la langue locale par défaut de votre ordinateur qui est utilisée. Si une langue est spécifiée mais qu'aucun pays n'est spécifié, le pays par défaut de la langue concernée est utilisé.

Vous ne pouvez pas indiquer de paramètres régionaux si vous n'avez pas indiqué de date.

Pour obtenir des informations sur les codes ISO locaux, consultez le site www.unicode.org.

style

optionnel

numérique

Style de format de date à utiliser pour la chaîne de caractères Unicode. Le style de format correspond à la norme relative aux paramètres régionaux spécifiés :

  • 0 : format complet, comme « Dimanche 18 septembre 2016 »
  • 1 : format long, comme « 18 septembre 2016 »
  • 2 : format moyen, comme « 18 sept. 2016 »
  • 3 : format numérique court, comme "18/09/16"

Si vous ignorez ce paramètre, c'est la valeur par défaut de 2 qui est utilisée. Vous ne pouvez pas indiquer de style si vous n'avez pas indiqué les paramètres régionaux .

Astuce

Pour obtenir de l'aide afin de déterminer le format prévu pour votre chaîne d'entrée, effectuez l'une des opérations suivantes :

  • Utilisez la fonction DTOU( ) pour générer un exemple de valeur à l'aide du style et des paramètres régionaux.

    Dans la ligne de commande, utilisez la commande DISPLAY pour imprimer la valeur :

    DISPLAY DTOU(`20160909`; "es_MX"; 3)
  • Consultez une source officielle sur le format de date standard pour connaître le style des paramètres locaux spécifiques.

Sortie

DateHeure. La valeur de date est générée à l'aide du format d'affichage de date Analytics actuel.

Exemples

Exemples basiques

Remarque

Tous les exemples supposent un format d'affichage de la date Analytics actuelle correspondant à JJ MMM AAAA.

Dans les exemples ci-dessous, le code régional pour le chinois ( "zh" ) et celui du chinois simplifié ( "zh_CN" ) correspondent à des chaînes d'entrée différentes et ils ne sont pas interchangeables.

Vous devez également indiquer le style correct. Une longue chaîne de date Unicode (c'est-à-dire une chaîne dont le style est 1) ne renvoie pas une date Analytics si vous indiquez un style de 2.

Valeurs d'introduction littérales

Renvoie `20141231` affiché au format 31 déc 2014 :

UTOD("31 de dezembro de 2014"; "pt_BR"; 1)

Renvoie `20141231` affiché au format 31 déc 2014 :

UTOD("31 grudnia 2014"; "pl"; 1)

Valeurs d'introduction champ

Renvoie la date équivalente pour chaque chaîne de caractères Unicode dans le champ Date_facture :

UTOD(Date_facture; "zh"; 1)

La valeur d'entrée utilise le style de date complet

Renvoie `20141231` affiché au format 31 déc 2014 (sans identifiant de région spécifié) :

UTOD("星期三; 2014 十二月 31"; "zh"; 0)

Renvoie `20141231` affiché au format 31 déc 2014 (identifiant de région spécifié) :

UTOD("2014年12月31日星期三"; "zh_CN"; 0)

La valeur d'entrée utilise le style de date long

Renvoie `20141231` affiché au format 31 déc 2014 (sans identifiant de région spécifié) :

UTOD("2014 十二月 31"; "zh"; 1)

Renvoie `20141231` affiché au format 31 déc 2014 (identifiant de région spécifié) :

UTOD("2014年12月31日"; "zh_CN"; 1)

Remarques

Réussite de la conversion de chaînes Unicode

Pour convertir avec succès des chaînes Unicode contenant des dates en dates Analytics, vous devez indiquer les paramètres local et style qui correspondent à la langue, au pays/région (le cas échéant), et le style de la date dans la chaîne Unicode.

Fonctions associées

UTOD ( ) est l'inverse de la fonction DTOU( ), qui convertit une date en chaîne Unicode. Si vous n'êtes pas certain du pays/région et du style à indiquer pour la fonction UTOD( ), vous pouvez utiliser DTOU( ) et expérimenter avec différents paramètres pour produire une chaîne Unicode de sortie correspondant à la forme des chaînes Unicode en entrée que vous souhaitez convertir avec UTOD( ).

Guide de création de scripts ACL 14.1