Fonctions Date/heure

Change une valeur temporelle dans le type temporel spécifié.

Retour

Une chaîne de date, heure ou date/heure dans le Formats standards FME d'heure et de date si la valeur en entrée est correctement, sinon nulle.

Syntaxe

@DateTimeCast(<datetime>,<targetType>[,<castType>])

Arguments

<datetime>

Une date, une heure ou une chaîne de dateheure en Formats standards FME d'heure et de date ou au format de date et d'heure ISO 8601. Lorsqu'un élément d'heure est manquant, minuit (000000) est supposé.

<targetType>

Sensible à la casse, peut être une date, une heure ou une dateheure. Les autres valeurs sont rejetées, avec le résultat défini sur null. Si <castType est strict_offset ou exact_match, <targetType> peut aussi etre time_offset ou datetime_offset.

<castType>

Peut être preserve_offset, strict_offset, ou exact_match.

• preserve_offset : si <datetime> inclut un décalage, il est préservé dans la sortie.
• strict_offset : Si <datetime> n'a pas de décalage (les décalages n'ont pas de valeur par défaut) et que <targetType> est time_offset ou datetime_offset, null est retourné. Si <targetType> est time ou datetime, tout décalage est abandonné.
• exact_match : Agit comme un validateur. Si <datetime> ne correspond pas exactement à <targetType>, null est retourné.

Exemples

@DateTimeCast(20170101,datetime) = 20170101000000

@DateTimeCast(20170101000000,date) = 20170101

@DateTimeCast(000000,date) = null

@DateTimeCast(20180821, time, exact_match) = null

@DateTimeCast(120000+08:00, time_offset, strict_offset) = 120000+08:00

@DateTimeCast(120000, time_offset, strict_offset) = null

Crée une chaîne date_heure.

Retour

Une chaîne de dateheure au format FME, contenant un décalage UTC si un décalage non vide est fourni. Si un argument d'entrée est invalide, null est retourné.

Syntaxe

@DateTimeCreate(<year>,<month>,<day>,<hours>,<minutes>,<seconds>,<offset>)

Arguments

<year>

Entier entre 1 et 9999.

<month>

Entier entre 1 et 12.

<day>

Entier entre 1 et 31 .

<hours>

Entier entre 0 et 23.

<minutes>

Entier entre 0 et 59.

<seconds>

Valeur décimale comprise entre 0 et 59.999999999.

<offset>

Chaîne de la forme +/-hh, +/-hhmm, ou +/-hh:mm. Peut également être la chaîne vide, "" , pour indiquer une heure non zonée.

Exemples

@DateTimeCreate(2017,1,2,0,0,0,"") = 20170102000000

@DateTimeCreate(2017,0,1,0,0,0) = null

Créer un intervalle représentant une période telle que 1 mois, 1 année, 1 jour et ainsi de suite.

Retour

Une chaîne de caractères au format de durée ISO 8601, sauf que les années, mois, jours, heures et minutes fractionnaires ne sont pas supportés. Si un argument d'entrée est invalide, null est renvoyé.

Syntaxe

@DateTimeIntervalCreate(<years>,<months>,<days>,<hours>,<minutes>,<seconds>[,<sign>])

Arguments

<years>

Entier.

<months>

Entier.

<days>

Entier.

<hours>

Entier.

<minutes>

Entier.

<seconds>

Entier.

<sign>

Valeur de chaîne de caractères facultative. Peut être l'une des valeurs suivantes :

• Non spécifié : l'intervalle est positif.
• +: l'intervalle est positif.
• − : L'intervalle est un intervalle négatif. Par exemple, P1M signifie un mois à partir d'une certaine date, et -P1M signifie un mois négatif à partir d'une certaine date.
• Autres valeurs : l'arguement est rejeté et le résultat est null.

Exemples

@DateTimeIntervalCreate(1,2,0,0,0,0.123) = P1Y2MT0.123S

@DateTimeIntervalCreate(1,0,-1,0,0,0) = null

@DateTimeIntervalCreate(0,0,1,0,0,0,-) = -P1D

Génère la date en cours en respectant la précision horaire.

Retour

Une chaîne de dateheure dans Formats standards FME d'heure et de date avec le type de décalage spécifié. Si le type de décalage n'est pas valide, null est retourné.

Syntaxe

@DateTimeNow([<offsetType>])

Arguments

<offsetType>

Les chaînes optionnelles sont insensibles à la casse et peuvent être :

• Non spécifiées : Identique à localUnzoned. (local sans fuseau).
• localUnzoned : Génère l'heure locale mais aucun fuseau n'est appliqué.
• local : génère l'heure locale, avec le décalage UTC local ajouté. Par exemple, l'heure normale du Pacifique a un décalage UTC de -08:00.
• utc: génère l'heure UTC avec un décalage +0:00.
• Autres valeurs : l'arguement est rejeté et le résultat est null.

Exemples

@DateTimeNow() = 20170202162035.1574322

@DateTimeNow(localUnzoned) = 20170202162035.1574322

@DateTimeNow(local) = 20170202162035.1574322-08:00

@DateTimeNow(utc)

= 20170203002035.1574322+00:00

Ajoute un intervalle, ou une période de temps, à une dateheure. Pour soustraire d'une dateheure, transforme en négatif <intervalle>. Par exemple, <intervalle> = P1M ajoute un mois à <datetime>. <intervalle> = -P1M soustrait un mois à <datetime>.

Retour

Une chaîne de dateheure dans Formats standards FME d'heure et de date qui a le même type temporel que l'entrée <datetime>, où les dates d'entrée sont automatiquement appelées en dateheures en ajoutant minuit si <interval> contient une composante de temps. Si l'un des arguments n'est pas valide, ou si <interval> contient des parties qui ne sont pas trouvées dans l'argument <datetime>, null est retourné.

Syntaxe

@DateTimeAdd(<datetime>,<interval>)

Arguments

<datetime>

Une chaîne date, heure ou date-heure Formats standards FME d'heure et de date ou  ISO 86061.

<interval>

Une chaîne au format durée ISO 8601, sauf les années, mois, jours, heures et minutes fractionnés non supportés.

Exemples

@DateTimeAdd(20170102,P1M) = 20170202

@DateTimeAdd(20160229,P1Y) = 20170228

@DateTimeAdd(20160229,-P1Y) = 20150228

@DateTimeAdd(000000,PT1H) = 010000

@DateTimeAdd(20170102,PT1H) = 20170102010000

@DateTimeAdd(000000,P1DT1H) = null

<endDatetime> - <startDatetime> = intervalle. Les valeurs de début et de fin doivent avoir le même type temporel, sinon le résultat est nul. La seule exception est que les dates sont autocastés en dateheure en ajoutant minuit si l'autre argument est une dateheure. Cette fonction prend en charge plusieurs types d'intervalles.

Retour

Une valeur d'intervalle dont le type est défini par <intervalType>. Si l'un des arguments d'entrée est invalide, ou si les valeurs de début et de fin ne sont pas du même type temporel (par exemple, date - datetime), null est renvoyé.

Syntaxe

@DateTimeDiff(<endDatetime>,<startDatetime>[,<intervalType>])

Arguments

<endDatetime>

Une chaîne de date, d'heure ou de dateheure au format Formats standards FME d'heure et de date ou date et heure ISO 8601. <endDatetime> doit être compatible avec <startDatetime>. Voir Matrice de compatibilité de type pour <endDatetime> et <startDatetime> ci-dessous.

<startDatetime>

Une chaîne de date, d'heure ou de dateheure au format Formats standards FME d'heure et de date ou date et heure ISO 8601. <startDatetime> doit être compatible avec <endDatetime>. Voir Matrice de compatibilité de type pour <endDatetime> et <startDatetime> ci-dessous.

<intervalType>

Can be one of the following string values, case-insensitive:

• Non-spécifié : sort l'intervalle au format de durée ISO 8601.

• Intervalle : Sort l'intervalle au format de durée ISO 8601.
• Années: Sort l'intervalle en tant qu'année fractionnée ou une année égale 12 mois.
• Mois : produit l'intervalle sous forme de mois fractionnés. Entre une paire de valeurs temporelles de début et de fin, il y a X mois complets. Le reste qui n'est pas un mois complet est constitué d'un nombre de jours, d'heures, de minutes et de secondes. Le reste est d'abord converti en jours fractionnés. Ensuite, les jours fractionnaires sont divisés par le nombre de jours d'un mois de transition. Le mois de croisement précède le reste et garantit que le reste n'est jamais supérieur à un mois, lorsqu'il est exprimé sous forme de fraction de mois. Enfin, le reste sous forme de fraction de mois est ajouté aux X mois complets, ce qui donne les mois fractionnés.
• Semaines : Sort l'intervalle en tant que semaines fractionnées où une semaine contient 7 jours.
• Jours: Sort l'intervalle en tant que jours fractionnés où une journée est composée de 24 heures.
• Heures: Sort l'intervalle en tant qu'heures fractionnées où une heure contient 60 minutes.
• Minutes: Sort l'intervalle en tant que minutes fractionnées où une minute contient 60 secondes.
• Secondes: Sort l'intervalle en tant que secondes fractionnées.

• Autres valeurs : l'arguement est rejeté et le résultat est null.

Matrice de compatibilité de type pour <endDatetime> et <startDatetime>

Les types end/start incompatibles résultent en un rejet de l'entité.

Exemples

@DateTimeDiff(20170407, 20170101) = P3M6D

@DateTimeDiff(20170407, 20170101, months) = 3.2000000000000002

@DateTimeDiff(20170407, 20170101, days) = 96

@DateTimeDiff(20170102010000, 20170102) = PT1H

@DateTimeDiff(20170102, 20170131020304-08:00) = null

Négativise les chaînes d'intervalles. Cette fonction peut être utilisée pour transformer @DateTimeAdd() en une fonction de soustraction.

Retour

Si l'entrée <intervalle> est invalide, null est retourné. Sinon, l'entrée <intervalle> avec son signe inversé. Cela signifie soit l'ajout d'un caractère "-", soit la suppression de ce caractère.

Syntaxe

@DateTimeIntervalNegate(<interval>)

Arguments

<interval>

Une chaîne au format durée ISO 8601, sauf les années, mois, jours, heures et minutes fractionnés non supportés.

Exemples

@DateTimeIntervalNegate(-P1M1D) = P1M1D

@DateTimeIntervalNegate(P1M1Y) = null

Retour

Une chaîne de date au Formats standards FME d'heure et de date. Si la date d'entrée n'est pas valide, null est renvoyé.

Syntaxe

@DateTimeRound(<datetime>,<round_type>,<unit>,<interval>)

Arguments

<datetime>

Une chaîne de caractères date, heure ou date-heure au Formats standards FME d'heure et de date ou date et heure au format ISO 8601.

<round_type>

Sens de l'arrondi :

• Up : Arrondit à l'intervalle supérieure de la valeur <unit> spécifiée.
• Down : Arrondit à l'intervalle le plus proche de la valeur <unit> spécifiée.
• Nearest : Arrondit à l'intervalle le plus proche de la valeur <unit> spécifiée.

<unit>

L'unité d'arrondi du temps. Les valeurs valides sont :

• Jours
• hours
• minutes
• seconds

<interval>

L'intervalle d'arrondi pour l'unité <unit> spécifiée. Cette valeur doit être un nombre entier qui se divise uniformément par la valeur maximale de l'unité de temps sélectionnée. Par exemple, une valeur d'intervalle de 5 est valable pour les minutes car elle se divise également en 60.

Exemples

@DateTimeRound(20170203170000.1234567,down,seconds,1) = 20170203170000

@DateTimeRound(20170203170000.1234567,up,seconds,5) = 20170203170005

@DateTimeRound(20170203170000.1234567,nearest,hours,5) = 20170203150000

Récupère le décalage UTC d'une date-heure zonées.

Retour

Le décalage UTC de la dateheure d'entrée si elle est zonée, et null sinon. Si l'entrée n'est pas une valeur de dateheure FME, null est retourné. Le décalage UTC retourné est converti dans le type de retour spécifié.

Syntaxe

@TimeZoneGet(<datetime>[,<returnType>])

Arguments

<datetime>

Une chaîne de caractères date, heure ou date-heure au Formats standards FME d'heure et de date ou date et heure au format ISO 8601.

<returnType>

Facultatif. S'applique uniquement si la dateheure de saisie est zonée. Doit être l'une des valeurs suivantes, insensible à la casse, ou l'entrée est rejetée :

• Non-spécifié : identique à utcOffset.
• utcOffset: Retourne le décalage UTC sous la forme (+|-)hh:mm.
• minutes: Retourne le décalage UTC en tant que minutes.
• seconds: Retourne le décalage UTC en tant que secondes.

Exemples

@TimeZoneGet(083000-08) = -08:00

@TimeZoneGet(083000+08) = +08:00

@TimeZoneGet(083000-01:30, minutes) = -90

@TimeZoneGet(083000+01:30, minutes) = 90

@TimeZoneGet(083000-01:30, seconds) = -5400

@TimeZoneGet(083000) = null

Supprime un décalage UTC d'une date-heure.

Retour

Si la date-heure en entrée est zonée, retourne la date-time en entrée avec le décalage UTC supprimé.

Si la date-heure en entrée est zonée, retourne la date-time inchangée.

Si l'entrée n'est pas une valeur date-heure ISO ou FME, un null est retourné.

Syntaxe

@TimeZoneRemove(<datetime>)

Arguments

<datetime>

Une chaîne de caractères date, heure ou date-heure au Formats standards FME d'heure et de date ou date et heure au format ISO 8601.

Exemples

@TimeZoneRemove(083000-08) = 083000

@TimeZoneRemove(083000) = 083000

@TimeZoneRemove(08:30) = null

Convertit/Définit le décalage UTC de l'entrée date-time.

Retour

Si la date-heure en entrée est zonée, retourne la date-time avec le décalage UTC convertit en un décalage UTC spécifié.

Si la date-heure en entrée est non-zonée, retourne la date-time en entrée avec le décalage UTC spécifié attaché.

Si un argument en entrée est invalide, null est retourné.

Syntaxe

@TimeZoneSet(<datetime>, <timeZone>[, <mode>])

Arguments

<datetime>

Une chaîne de caractères date, heure ou date-heure au Formats standards FME d'heure et de date ou date et heure au format ISO 8601.

<timeZone>

Peut être l'une des valeurs suivantes, insensibles à la casse :

• local : Le décalage UTC du fuseau horaire local qui était en vigueur au moment de la valeur de dateheure. En mode convert, cela convertit une valeur dateheure avec décalage en heure locale équivalente, en respectant les règles de l'heure d'été. En mode réinitialisation, tout décalage existant est ignoré, et la dateheure est associée à un décalage UTC applicable à l'heure locale. ( Le mode réinitialisation échoue s'il n'y a pas d'heure locale associée en raison d'une heure sautée lorsque l'heure d'été prend effet, ou pendant une heure répétée ambiguë lorsque l'heure standard prend effet).
• utc: Le décalage UTC +00:00.
• Un décalage UTC sous la forme (+|-)hh:mm.

<mode>

Doit être l'une valeurs suivantes, insensibles à la casse, ou l'entrée est rejetée :

• Non-spécifié : identique à auto.
• auto: Définit le fuseau horaire si l'entrée est non-zonée et convertit le fuseau horaire si l'entrée est zonée.
• reset: Supprime tout décalage UTC puis définit le définit selon la cible <timeZone>.
• convert : L'entrée non zonée est rejetée. L'entrée zonée est convertie du décalage UTC source vers la cible <timeZone>.

Exemples

@TimeZoneSet(083000, -08:00) = 083000-08:00

@TimeZoneSet(083000, -08:00, convert) = null

@TimeZoneSet(083000-01:00, -08:00) = 013000-08:00

@TimeZoneSet(083000-01:00, local) = null

@TimeZoneSet(083000-01:00, utc) = 093000+00:00

@TimeZoneSet(083000-01:00, -08:00, reset) = 083000-08:00

Analyse les chaînes contenant des informations de dateheure à partir d'une source arbitraire, et produit des chaînes de date, heure et dateheure au format Formats standards FME d'heure et de date ou ISO 8601. La chaîne de format est sensible à la casse, sauf indication contraire. La fonction parse parcourt la chaîne d'entrée et la compare à la chaîne de format.

Retour

Date, heure ou chaîne de dateheure en Formats standards FME d'heure et de date, selon les indicateurs de format. Si la chaîne de caractères d'entrée correspond entièrement à la chaîne de caractères d'entrée avant que la chaîne de caractères de format ne soit entièrement appliquée, le résultat est défini comme nul. Toutefois, la chaîne de format peut correspondre au début d'une chaîne d'entrée. Par exemple, @DateTimeParse(2017-01-02 03:04:05,%Y-%m-%d) = 20170102. Si la chaîne de format n'a pas permis d'analyser les informations temporelles, ou si l'un des indicateurs d'analyse n'a pas permis de récupérer les informations temporelles attendues, le résultat est défini comme nul.

Syntaxe

@DateTimeParse(<string>,<format>[,<mode>])

Arguments

<string>

Chaîne d'entrée arbitraire contenant des informations temporelles. La chaîne d'entrée est coupée des espaces de début et de fin. L'information temporelle doit satisfaire aux exigences suivantes, sinon elle est rejetée et le résultat est défini comme nul :

• Année, mois et jour sont fournis ensemble, dans n'importe quel ordre, à travers une combinaison de paramètres de formats comme %Y-%m-%d.
• Si les heures sont renseignées par des chaînes de format %H ou %I, mais pas les minutes ou les secondes, ces dernières se voient attribuer la valeur par défaut 00. Cela permet d'analyser les entrées sous la forme 12AM ou 3PM.
• Similairement, si les heures et minutes sont peuplées mais pas les secondes, la seconde partie se voit assigner une valeur par défaut de 00.

<format>

Chaîne de format contenant les drapeaux de format pris en charge, les caractères réguliers et les caractères spéciaux. La chaîne de format est débarrassée des espaces avant et arrière. Les chaînes de format vides et les indicateurs de format non pris en charge entraînent la mise à zéro du résultat.

La priorité des indicateurs d'analyse, de la plus haute à la plus basse, est la suivante : %s ou %Es, %z, %j, tous les autres indicateurs. Lorsque les autres indicateurs se chevauchent - par exemple, si %B et %m sont tous deux spécifiés - alors celui qui est spécifié en dernier prévaut.

<mode>

Valeur de chaîne facultative. Peut être l'une des valeurs suivantes, insensible à la casse :

• Non-spécifié : les parties temporelles en entrée doivent respecter les plages documentées.
• repair (insensible à la casse) : caractères dépassant seront rejetés (par exemple, le mois 0) mais les parties en dépassement (autres que les années) seront réparées de manière à ce que toutes les parties soient ramenées dans la plage (par exemple, le mois 13 entraînera l'incrémentation de l'année par 1, et le mois sera mis à 1). %I n'est pas couvert par ce mode, car il est ambigu de savoir comment 13:00AM doit être réparé - comme 13:00 (traiter AM comme un élément étranger), ou 01:00 (l'heure après 12AM) ?
• Autres valeurs : l'arguement est rejeté et le résultat est null.

Exemples

Voir Paramètres et Exemples de Chaîne de Formatage.

Formate les chaînes de date, d'heure et de dateheure FME ou ISO dans un format personnalisé, pour être utilisées par les Writers et les Transformers. La chaîne de format est sensible à la casse.

Retour

Une chaîne formatée, si les arguments d'entrée sont valides. Si l'un ou l'autre des arguments n'est pas valide (par exemple, la chaîne de format contient des drapeaux non supportés étant donné le type temporel de la dateheure d'entrée), cette fonction renvoie null.

Syntaxe

@DateTimeFormat(<datetime>,<format>)

Arguments

<datetime>

Date, heure ou chaîne de dateheure en Formats standards FME d'heure et de date ou au format date et heure ISO 8601. Les dates saisies seront converties automatiquement en dateheure en ajoutant minuit si la chaîne de format produit des éléments d'heure.

<format>

Chaîne de format contenant les indicateurs de format et les caractères réguliers pris en charge. La chaîne de format est débarrassée des espaces avant et arrière. Les chaînes de format vides et les indicateurs de format non pris en charge entraînent la mise à zéro du résultat. Certains indicateurs de format pris en charge sont rejetés pour certains types de temporaires d'entrée, ce qui entraîne l'attribution de la valeur null au résultat. Plus précisément :

• Si l'entrée est une date ou date-heure, rejette :

%s %z %Ez

• Si l'entrée est une heure ou une heure avec décalage, rejette :

%s %Es %Y %y %m %N %b %B %u %U %w %W %d %e %j %a %A

• Si l'entrée est une heure, en dehors des paramètres précédents, rejette :

%z %Ez

• Si l'entrée est une date-heure avec décalage, rejette :

%Es

Exemples

Voir Paramètres et Exemples de Chaîne de Formatage.