

Pour des fonctionnalités similaires à celles d'Amazon Timestream pour, pensez à Amazon Timestream LiveAnalytics pour InfluxDB. Il permet une ingestion simplifiée des données et des temps de réponse aux requêtes à un chiffre en millisecondes pour des analyses en temps réel. Pour en savoir plus, [cliquez ici](https://docs.aws.amazon.com//timestream/latest/developerguide/timestream-for-influxdb.html).

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Fonctions de date/heure
<a name="date-time-functions"></a>

**Note**  
Timestream for LiveAnalytics ne prend pas en charge les valeurs temporelles négatives. Toute opération entraînant une durée négative entraîne une erreur.

Timestream pour LiveAnalytics utilise le fuseau horaire UTC pour la date et l'heure. Timestream prend en charge les fonctions suivantes pour la date et l'heure.

**Topics**
+ [Généralités et conversion](#date-time-functions-general)
+ [Intervalle et durée](#date-time-functions-interval-duration)
+ [Formatage et analyse](#date-time-functions-formatting-parsing)
+ [Extraction](#date-time-functions-extraction)

## Généralités et conversion
<a name="date-time-functions-general"></a>

Timestream for LiveAnalytics prend en charge les fonctions générales et de conversion suivantes pour la date et l'heure.


| Fonction | Type de données de sortie | Description | 
| --- | --- | --- | 
|  date\$1actuelle  |  date  |  Renvoie la date actuelle en UTC. Aucune parenthèse n'est utilisée. <pre>SELECT current_date</pre> Exemple de résultat : `2022-07-07`  Il s'agit également d'un mot clé réservé. Pour obtenir la liste des mots clés réservés, consultez[Mots-clés réservés](ts-limits.md#limits.reserved).   | 
|  heure\$1actuelle  |  time  |  Renvoie l'heure actuelle en UTC. Aucune parenthèse n'est utilisée. <pre>SELECT current_time</pre> Exemple de résultat : `17:41:52.827000000`  Il s'agit également d'un mot clé réservé. Pour obtenir la liste des mots clés réservés, consultez[Mots-clés réservés](ts-limits.md#limits.reserved).   | 
|  current\$1timestamp ou now ()  |  timestamp  |  Renvoie l'horodatage actuel en UTC. <pre>SELECT current_timestamp</pre> Exemple de résultat : `2022-07-07 17:42:32.939000000`  Il s'agit également d'un mot clé réservé. Pour obtenir la liste des mots clés réservés, consultez[Mots-clés réservés](ts-limits.md#limits.reserved).   | 
|  fuse\$1horaire actuel ()  |  varchar La valeur sera « UTC ».  |  Timestream utilise le fuseau horaire UTC pour la date et l'heure. <pre>SELECT current_timezone()</pre> Exemple de résultat : `UTC`  | 
|  date (varchar (x)), date (horodatage)  |  date  |  <pre>SELECT date(TIMESTAMP '2022-07-07 17:44:43.771000000')</pre> Exemple de résultat : `2022-07-07`  | 
|  dernier\$1jour\$1de\$1mois (horodatage), dernier\$1jour\$1de\$1mois (date)  |  date  |  <pre>SELECT last_day_of_month(TIMESTAMP '2022-07-07 17:44:43.771000000')</pre> Exemple de résultat : `2022-07-31`  | 
|  from\$1iso8601\$1timestamp (chaîne de caractères)  |  timestamp  |  Analyse l'horodatage ISO 8601 au format d'horodatage interne. <pre>SELECT from_iso8601_timestamp('2022-06-17T08:04:05.000000000+05:00')</pre> Exemple de résultat : `2022-06-17 03:04:05.000000000`  | 
|  from\$1iso8601\$1date (chaîne de caractères)  |  date  |  Analyse la chaîne de date ISO 8601 au format d'horodatage interne pour UTC 00:00:00 de la date spécifiée. <pre>SELECT from_iso8601_date('2022-07-17')</pre> Exemple de résultat : `2022-07-17`  | 
|  to\$1iso8601 (horodatage), to\$1iso8601 (date)  |  varchar  |  Renvoie une chaîne au format ISO 8601 pour l'entrée. <pre>SELECT to_iso8601(from_iso8601_date('2022-06-17'))</pre> Exemple de résultat : `2022-06-17`  | 
|  from\$1milliseconds (bigint)  |  timestamp  |  <pre>SELECT from_milliseconds(1)</pre> Exemple de résultat : `1970-01-01 00:00:00.001000000`  | 
|  from\$1nanoseconds (bigint)  |  timestamp  |  <pre>select from_nanoseconds(300000001)</pre> Exemple de résultat : `1970-01-01 00:00:00.300000001`  | 
|  from\$1unixtime (double)  |  timestamp  |  Renvoie un horodatage qui correspond à l'unixtime fourni. <pre>SELECT from_unixtime(1)</pre> Exemple de résultat : `1970-01-01 00:00:01.000000000`  | 
|  heure locale  |  time  |  Renvoie l'heure actuelle en UTC. Aucune parenthèse n'est utilisée. <pre>SELECT localtime</pre> Exemple de résultat : `17:58:22.654000000`  Il s'agit également d'un mot clé réservé. Pour obtenir la liste des mots clés réservés, consultez[Mots-clés réservés](ts-limits.md#limits.reserved).   | 
|  horodatage local  |  timestamp  |  Renvoie l'horodatage actuel en UTC. Aucune parenthèse n'est utilisée. <pre>SELECT localtimestamp</pre> Exemple de résultat : `2022-07-07 17:59:04.368000000`  Il s'agit également d'un mot clé réservé. Pour obtenir la liste des mots clés réservés, consultez[Mots-clés réservés](ts-limits.md#limits.reserved).   | 
|  to\$1milliseconds (intervalle jour par seconde), to\$1milliseconds (horodatage)  |  bigint  |  <pre>SELECT to_milliseconds(INTERVAL '2' DAY + INTERVAL '3' HOUR)</pre> Exemple de résultat : `183600000` <pre>SELECT to_milliseconds(TIMESTAMP '2022-06-17 17:44:43.771000000')</pre> Exemple de résultat : `1655487883771`  | 
|  to\$1nanoseconds (intervalle jour par seconde), to\$1nanoseconds (horodatage)  |  bigint  |  <pre>SELECT to_nanoseconds(INTERVAL '2' DAY + INTERVAL '3' HOUR)</pre> Exemple de résultat : `183600000000000` <pre>SELECT to_nanoseconds(TIMESTAMP '2022-06-17 17:44:43.771000678')</pre> Exemple de résultat : `1655487883771000678`  | 
|  to\$1unixtime (horodatage)  |  double  |  Renvoie unixtime pour l'horodatage fourni. <pre>SELECT to_unixtime('2022-06-17 17:44:43.771000000')</pre> Exemple de résultat : `1.6554878837710001E9`  | 
|  date\$1trunc (unité, horodatage)  |  timestamp  |  Renvoie l'horodatage tronqué en unité, où l'unité est [seconde, minute, heure, jour, semaine, mois, trimestre ou année]. <pre>SELECT date_trunc('minute', TIMESTAMP '2022-06-17 17:44:43.771000000')</pre> Exemple de résultat : `2022-06-17 17:44:00.000000000`  | 

## Intervalle et durée
<a name="date-time-functions-interval-duration"></a>

Timestream for LiveAnalytics prend en charge les fonctions d'intervalle et de durée suivantes pour la date et l'heure.


| Fonction | Type de données de sortie | Description | 
| --- | --- | --- | 
|  date\$1add (unité, bigint, date), date\$1add (unité, bigint, heure), date\$1add (varchar (x), bigint, horodatage)  |  timestamp  |  Ajoute un bigint d'unités, où l'unité est l'une des valeurs suivantes : [seconde, minute, heure, jour, semaine, mois, trimestre ou année]. <pre>SELECT date_add('hour', 9, TIMESTAMP '2022-06-17 00:00:00')</pre> Exemple de résultat : `2022-06-17 09:00:00.000000000`  | 
|  date\$1diff (unité, date, date), date\$1diff (unité, heure, heure), date\$1diff (unité, horodatage, horodatage)  |  bigint  |  Renvoie une différence dont l'unité est [seconde, minute, heure, jour, semaine, mois, trimestre ou année]. <pre>SELECT date_diff('day', DATE '2020-03-01', DATE '2020-03-02')</pre> Exemple de résultat : `1`  | 
|  parse\$1duration (chaîne de caractères)  |  interval  |  Analyse la chaîne d'entrée pour renvoyer un `interval` équivalent. <pre>SELECT parse_duration('42.8ms')</pre> Exemple de résultat : `0 00:00:00.042800000` <pre>SELECT typeof(parse_duration('42.8ms'))</pre> Exemple de résultat : `interval day to second`  | 
| bin (horodatage, intervalle) | timestamp |  Arrondit la valeur entière du `timestamp` paramètre au multiple le plus proche de la valeur entière du `interval` paramètre. La signification de cette valeur de retour n'est peut-être pas évidente. Il est calculé à l'aide de l'arithmétique des entiers en divisant d'abord le nombre entier d'horodatage par l'entier d'intervalle, puis en multipliant le résultat par l'entier d'intervalle. En gardant à l'esprit qu'un horodatage indique un point UTC exprimé en fractions de seconde écoulées depuis l'époque POSIX (1er janvier 1970), la valeur renvoyée s'alignera rarement sur les unités du calendrier. Par exemple, si vous spécifiez un intervalle de 30 jours, tous les jours écoulés depuis l'époque sont divisés en tranches de 30 jours, et le début de la dernière tranche de 30 jours est renvoyé, ce qui n'a aucun rapport avec les mois du calendrier. Voici quelques exemples : <pre>bin(TIMESTAMP '2022-06-17 10:15:20', 5m)     ==> 2022-06-17 10:15:00.000000000<br />bin(TIMESTAMP '2022-06-17 10:15:20', 1d)     ==> 2022-06-17 00:00:00.000000000<br />bin(TIMESTAMP '2022-06-17 10:15:20', 10day)  ==> 2022-06-17 00:00:00.000000000<br />bin(TIMESTAMP '2022-06-17 10:15:20', 30day)  ==> 2022-05-28 00:00:00.000000000</pre>  | 
|  il y a (intervalle)  |  timestamp  |  Renvoie la valeur correspondant à `interval` current\$1timestamp. <pre>SELECT ago(1d)</pre> Exemple de résultat : `2022-07-06 21:08:53.245000000`  | 
|  littéraux d'intervalle tels que 1h, 1d et 30m  |  interval  |  Les littéraux d'intervalle sont pratiques pour parse\$1duration (chaîne). Par exemple, `1d` est identique à `parse_duration('1d')`. Cela permet d'utiliser les littéraux partout où un intervalle est utilisé. Par exemple : `ago(1d)` et `bin(<timestamp>, 1m)`.  | 

Certains littéraux d'intervalle servent de raccourci pour parse\$1duration. Par exemple,`parse_duration('1day')`, `1day``parse_duration('1d')`, et `1d` chaque retour `1 00:00:00.000000000` où se trouve le type`interval day to second`. L'espace est autorisé dans le format fourni à`parse_duration`. Par exemple, les retours sont `parse_duration('1day')` également`00:00:00.000000000`. Mais ce n'`1 day`est pas un intervalle littéral.

Les unités associées `interval day to second` sont ns, nanoseconde, us, microseconde, ms, milliseconde, s, seconde, m, minute, h, heure, d et jour.

Il y en a également`interval year to month`. Les unités associées à l'intervalle d'une année à l'autre sont y, année et mois. Par exemple, les `SELECT 1year` retours`1-0`. `SELECT 12month`revient également`1-0`. `SELECT 8month`retours`0-8`.

Bien que l'unité de `quarter` soit également disponible pour certaines fonctions telles que `date_trunc` et`date_add`, elle n'`quarter`est pas disponible dans le cadre d'un intervalle littéral.

## Formatage et analyse
<a name="date-time-functions-formatting-parsing"></a>

Timestream for LiveAnalytics prend en charge les fonctions de formatage et d'analyse suivantes pour la date et l'heure.


| Fonction | Type de données de sortie | Description | 
| --- | --- | --- | 
|  date\$1format (horodatage, varchar (x))  |  varchar  |  [Pour plus d'informations sur les spécificateurs de format utilisés par cette fonction, voir \$1 https://trino.io/docs/current/functions/datetime.html mysql-date-functions](https://trino.io/docs/current/functions/datetime.html#mysql-date-functions) <pre>SELECT date_format(TIMESTAMP '2019-10-20 10:20:20', '%Y-%m-%d %H:%i:%s')</pre> Exemple de résultat : `2019-10-20 10:20:20`  | 
|  date\$1parse (varchar (x), varchar (y))  |  timestamp  |  [Pour plus d'informations sur les spécificateurs de format utilisés par cette fonction, voir \$1 https://trino.io/docs/current/functions/datetime.html mysql-date-functions](https://trino.io/docs/current/functions/datetime.html#mysql-date-functions) <pre>SELECT date_parse('2019-10-20 10:20:20', '%Y-%m-%d %H:%i:%s')</pre> Exemple de résultat : `2019-10-20 10:20:20.000000000`  | 
|  format\$1datetime (horodatage, varchar (x))  |  varchar  |  Pour plus d'informations sur la chaîne de format utilisée par cette fonction, consultez [http://joda-time.sourceforge. net/apidocs/org/joda/time/format/DateTimeFormat.html](http://joda-time.sourceforge.net/apidocs/org/joda/time/format/DateTimeFormat.html) <pre>SELECT format_datetime(parse_datetime('1968-01-13 12', 'yyyy-MM-dd HH'), 'yyyy-MM-dd HH')</pre> Exemple de résultat : `1968-01-13 12`  | 
|  parse\$1datetime (varchar (x), varchar (y))  |  timestamp  |  Pour plus d'informations sur la chaîne de format utilisée par cette fonction, consultez [http://joda-time.sourceforge. net/apidocs/org/joda/time/format/DateTimeFormat.html](http://joda-time.sourceforge.net/apidocs/org/joda/time/format/DateTimeFormat.html) <pre>SELECT parse_datetime('2019-12-29 10:10 PST', 'uuuu-LL-dd HH:mm z')</pre> Exemple de résultat : `2019-12-29 18:10:00.000000000`  | 

## Extraction
<a name="date-time-functions-extraction"></a>

Timestream for LiveAnalytics prend en charge les fonctions d'extraction suivantes pour la date et l'heure. La fonction d'extraction est à la base des autres fonctions pratiques.


| Fonction | Type de données de sortie | Description | 
| --- | --- | --- | 
|  extract  |  bigint  |  Extrait un champ d'un horodatage, le champ étant l'un des suivants : [YEAR, QUARTER, MONTH, WEEK, DAY, DAY\$1OF\$1MONTH, DAY\$1OF\$1WEEK, DOW, DAY\$1OF\$1YEAR, DOY, YEAR\$1OF\$1WEEK, YOW, HOUR, MINUTE ou SECOND]. <pre>SELECT extract(YEAR FROM '2019-10-12 23:10:34.000000000')</pre> Exemple de résultat : `2019`  | 
|  jour (horodatage), jour (date), jour (intervalle de jour à seconde)  |  bigint  |  <pre>SELECT day('2019-10-12 23:10:34.000000000')</pre> Exemple de résultat : `12`  | 
|  jour\$1of\$1month (horodatage), day\$1of\$1month (date), day\$1of\$1month (intervalle d'un jour à une seconde)  |  bigint  |  <pre>SELECT day_of_month('2019-10-12 23:10:34.000000000')</pre> Exemple de résultat : `12`  | 
|  jour\$1de\$1semaine (horodatage), jour\$1de\$1semaine (date)  |  bigint  |  <pre>SELECT day_of_week('2019-10-12 23:10:34.000000000')</pre> Exemple de résultat : `6`  | 
|  jour\$1de\$1année (horodatage), jour\$1de\$1année (date)  |  bigint  |  <pre>SELECT day_of_year('2019-10-12 23:10:34.000000000')</pre> Exemple de résultat : `285`  | 
|  dow (horodatage), dow (date)  |  bigint  |  Alias pour day\$1of\$1week  | 
|  doy (horodatage), doy (date)  |  bigint  |  Alias pour day\$1of\$1year  | 
|  heure (horodatage), heure (heure), heure (intervalle du jour à la seconde)  |  bigint  |  <pre>SELECT hour('2019-10-12 23:10:34.000000000')</pre> Exemple de résultat : `23`  | 
|  milliseconde (horodatage), milliseconde (heure), milliseconde (intervalle jour par seconde)  |  bigint  |  <pre>SELECT millisecond('2019-10-12 23:10:34.000000000')</pre> Exemple de résultat : `0`  | 
|  minute (horodatage), minute (heure), minute (intervalle du jour à la seconde)  |  bigint  |  <pre>SELECT minute('2019-10-12 23:10:34.000000000')</pre> Exemple de résultat : `10`  | 
|  mois (horodatage), mois (date), mois (intervalle d'une année à l'autre)  |  bigint  |  <pre>SELECT month('2019-10-12 23:10:34.000000000')</pre> Exemple de résultat : `10`  | 
|  nanoseconde (horodatage), nanoseconde (temps), nanoseconde (intervalle entre un jour et une seconde)  |  bigint  |  <pre>SELECT nanosecond(current_timestamp)</pre> Exemple de résultat : `162000000`  | 
|  trimestre (horodatage), trimestre (date)  |  bigint  |  <pre>SELECT quarter('2019-10-12 23:10:34.000000000')</pre> Exemple de résultat : `4`  | 
|  seconde (horodatage), seconde (heure), seconde (intervalle de jour à seconde)  |  bigint  |  <pre>SELECT second('2019-10-12 23:10:34.000000000')</pre> Exemple de résultat : `34`  | 
|  semaine (horodatage), semaine (date)  |  bigint  |  <pre>SELECT week('2019-10-12 23:10:34.000000000')</pre> Exemple de résultat : `41`  | 
|  semaine\$1de\$1année (horodatage), semaine\$1de\$1année (date)  |  bigint  |  Alias pour la semaine  | 
|  année (horodatage), année (date), année (intervalle d'une année à l'autre)  |  bigint  |  <pre>SELECT year('2019-10-12 23:10:34.000000000')</pre> Exemple de résultat : `2019`  | 
|  année\$1de\$1semaine (horodatage), année\$1de\$1semaine (date)  |  bigint  |  <pre>SELECT year_of_week('2019-10-12 23:10:34.000000000')</pre> Exemple de résultat : `2019`  | 
|  yow (horodatage), yow (date)  |  bigint  |  Alias pour year\$1of\$1week  | 