Opérateur CalendarTime (FPScript)
Convertit une expression en un type de données de temps calendaire.
Syntaxe
CalendarTime Expression
La syntaxe de l'opérateur CalendarTime est constituée des éléments suivants :
Élément |
Description |
|---|---|
Expression |
Toute expression. Tous les types de données sont autorisés. |
Remarques
L'opérateur peut traiter des valeurs scalaires ou des séries de données entières et des matrices de données. Si Expression est une série de données ou une matrice de données, la conversion de type s'effectue sur une base par élément et le résultat est à nouveau une série de données ou une matrice de données. Si un signal, une série de signaux ou une courbe 3D est converti, seule la composante Y est examinée. Le résultat contient la composante Y convertie sous forme de série de données ou de matrice de données. Si Expression est une liste, alors l'opération est exécutée pour chaque élément de la liste et le résultat est également une liste.
Lors de la conversion d'une valeur numérique en une valeur de temps calendaire, celle-ci est interprétée comme le nombre de secondes depuis le 1/1/1970 en temps universel (UTC). Les calendriers antérieurs à cette date ne sont pas pris en charge, c'est-à-dire les calendriers qui, considérés comme des valeurs à virgule flottante, donnent une valeur négative. La transformation d'un nombre négatif en une valeur de temps calendaire aboutit donc à une valeur de temps calendaire invalide. La valeur absolue est formée pour les types de données complexes. La conversion d'une chaîne de caractères en une valeur temporelle calendaire dépend des paramètres de date et d'heure de Windows. Vous devez utiliser le format "Month/Day/Year Hour:Minute:Second.fractional digits" ou "Day.Month.Year Hour:Minute:Second.fractional digits" et spécifier une année à quatre chiffres. Vous devez utiliser la configuration du symbole décimal dans les Options FlexPro pour les secondes fractionnelles. Le type Empty donne une valeur de temps calendaire invalide.
Si l'expression est une quantité, alors elle doit avoir la dimension SI du temps et elle sera transformée en unité s avant la conversion.
Disponible dans
FlexPro View, Basic, Professional, Developer Suite
Exemples
Heure du calendrier 1090929767.0 |
Renvoie la valeur de l'heure du calendrier '04/27/2004 14:02:47'. |
CalendarTime "23.12.2004 12:13:14.56" |
Retourne '23/12/2004 12:13:14.56'. |
Calendrier-heure vide |
Renvoie '?/?/?'. |
Heure du calendrier -1 |
Renvoie '?/?/?'. |
Heure du calendrier 1090929767.0E+03 ms |
Renvoie la valeur de l'heure du calendrier '04/27/2004 14:02:47'. |
Voir aussi
Opérateur ComplexFloatingPoint32