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 :
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 :
|
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( ).