

Per funzionalità simili a Amazon Timestream for, prendi in considerazione Amazon Timestream LiveAnalytics per InfluxDB. Offre un'acquisizione semplificata dei dati e tempi di risposta alle query di una sola cifra di millisecondi per analisi in tempo reale. [Scopri](https://docs.aws.amazon.com//timestream/latest/developerguide/timestream-for-influxdb.html) di più qui.

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Funzioni data/ora
<a name="date-time-functions"></a>

**Nota**  
Timestream for non LiveAnalytics supporta valori temporali negativi. Qualsiasi operazione che genera un tempo negativo genera un errore.

Timestream for LiveAnalytics utilizza il fuso orario UTC per data e ora. Timestream supporta le seguenti funzioni per data e ora.

**Topics**
+ [Generale e conversione](#date-time-functions-general)
+ [Intervallo e durata](#date-time-functions-interval-duration)
+ [Formattazione e analisi](#date-time-functions-formatting-parsing)
+ [Estrazione](#date-time-functions-extraction)

## Generale e conversione
<a name="date-time-functions-general"></a>

Timestream for LiveAnalytics supporta le seguenti funzioni generali e di conversione per data e ora.


| Funzione | Tipo di dati di output | Description | 
| --- | --- | --- | 
|  data\$1corrente  |  data  |  Restituisce la data corrente in UTC. Nessuna parentesi utilizzata. <pre>SELECT current_date</pre> Risultato di esempio: `2022-07-07`  Anche questa è una parola chiave riservata. Per un elenco di parole chiave riservate, vedere[Parole chiave riservate](ts-limits.md#limits.reserved).   | 
|  tempo\$1corrente  |  time  |  Restituisce l'ora corrente in UTC. Nessuna parentesi utilizzata. <pre>SELECT current_time</pre> Risultato di esempio: `17:41:52.827000000`  Anche questa è una parola chiave riservata. Per un elenco di parole chiave riservate, vedere[Parole chiave riservate](ts-limits.md#limits.reserved).   | 
|  current\$1timestamp o now ()  |  timestamp  |  Restituisce il timestamp corrente in UTC. <pre>SELECT current_timestamp</pre> Risultato di esempio: `2022-07-07 17:42:32.939000000`  Anche questa è una parola chiave riservata. Per un elenco di parole chiave riservate, vedere[Parole chiave riservate](ts-limits.md#limits.reserved).   | 
|  current\$1timezone ()  |  varchar Il valore sarà 'UTC.'  |  Timestream utilizza il fuso orario UTC per data e ora. <pre>SELECT current_timezone()</pre> Risultato di esempio: `UTC`  | 
|  data (varchar (x)), data (timestamp)  |  data  |  <pre>SELECT date(TIMESTAMP '2022-07-07 17:44:43.771000000')</pre> Risultato di esempio: `2022-07-07`  | 
|  last\$1day\$1of\$1month (timestamp), last\$1day\$1of\$1month (data)  |  data  |  <pre>SELECT last_day_of_month(TIMESTAMP '2022-07-07 17:44:43.771000000')</pre> Risultato di esempio: `2022-07-31`  | 
|  from\$1iso8601\$1timestamp (stringa)  |  timestamp  |  Analizza il timestamp ISO 8601 nel formato timestamp interno. <pre>SELECT from_iso8601_timestamp('2022-06-17T08:04:05.000000000+05:00')</pre> Risultato di esempio: `2022-06-17 03:04:05.000000000`  | 
|  from\$1iso8601\$1date (stringa)  |  data  |  Analizza la stringa di data ISO 8601 nel formato timestamp interno per l'UTC 00:00:00 della data specificata. <pre>SELECT from_iso8601_date('2022-07-17')</pre> Risultato di esempio: `2022-07-17`  | 
|  to\$1iso8601 (timestamp), to\$1iso8601 (data)  |  varchar  |  Restituisce una stringa in formato ISO 8601 per l'input. <pre>SELECT to_iso8601(from_iso8601_date('2022-06-17'))</pre> Risultato di esempio: `2022-06-17`  | 
|  from\$1milliseconds (bigint)  |  timestamp  |  <pre>SELECT from_milliseconds(1)</pre> Risultato di esempio: `1970-01-01 00:00:00.001000000`  | 
|  from\$1nanoseconds (bigint)  |  timestamp  |  <pre>select from_nanoseconds(300000001)</pre> Risultato di esempio: `1970-01-01 00:00:00.300000001`  | 
|  from\$1unixtime (double)  |  timestamp  |  Restituisce un timestamp che corrisponde all'unixtime fornito. <pre>SELECT from_unixtime(1)</pre> Risultato di esempio: `1970-01-01 00:00:01.000000000`  | 
|  ora locale  |  time  |  Restituisce l'ora corrente in UTC. Nessuna parentesi utilizzata. <pre>SELECT localtime</pre> Risultato di esempio: `17:58:22.654000000`  Anche questa è una parola chiave riservata. Per un elenco di parole chiave riservate, vedere[Parole chiave riservate](ts-limits.md#limits.reserved).   | 
|  timestamp locale  |  timestamp  |  Restituisce il timestamp corrente in UTC. Nessuna parentesi utilizzata. <pre>SELECT localtimestamp</pre> Risultato di esempio: `2022-07-07 17:59:04.368000000`  Anche questa è una parola chiave riservata. Per un elenco di parole chiave riservate, vedere[Parole chiave riservate](ts-limits.md#limits.reserved).   | 
|  to\$1milliseconds (intervallo da giorno a secondo), to\$1milliseconds (timestamp)  |  bigint  |  <pre>SELECT to_milliseconds(INTERVAL '2' DAY + INTERVAL '3' HOUR)</pre> Risultato di esempio: `183600000` <pre>SELECT to_milliseconds(TIMESTAMP '2022-06-17 17:44:43.771000000')</pre> Risultato di esempio: `1655487883771`  | 
|  to\$1nanoseconds (intervallo da giorno a secondo), to\$1nanoseconds (timestamp)  |  bigint  |  <pre>SELECT to_nanoseconds(INTERVAL '2' DAY + INTERVAL '3' HOUR)</pre> Risultato di esempio: `183600000000000` <pre>SELECT to_nanoseconds(TIMESTAMP '2022-06-17 17:44:43.771000678')</pre> Risultato di esempio: `1655487883771000678`  | 
|  to\$1unixtime (timestamp)  |  virgola mobile a doppia precisione  |  Restituisce unixtime per il timestamp fornito. <pre>SELECT to_unixtime('2022-06-17 17:44:43.771000000')</pre> Risultato di esempio: `1.6554878837710001E9`  | 
|  date\$1trunc (unità, timestamp)  |  timestamp  |  Restituisce il timestamp troncato in unità, dove l'unità è uno dei [secondo, minuto, ora, giorno, settimana, mese, trimestre o anno]. <pre>SELECT date_trunc('minute', TIMESTAMP '2022-06-17 17:44:43.771000000')</pre> Risultato di esempio: `2022-06-17 17:44:00.000000000`  | 

## Intervallo e durata
<a name="date-time-functions-interval-duration"></a>

Timestream for LiveAnalytics supporta le seguenti funzioni di intervallo e durata per data e ora.


| Funzione | Tipo di dati di output | Description | 
| --- | --- | --- | 
|  date\$1add (unit, bigint, date), date\$1add (unit, bigint, time), date\$1add (varchar (x), bigint, timestamp)  |  timestamp  |  Aggiunge un insieme di unità, dove l'unità è una tra [secondo, minuto, ora, giorno, settimana, mese, trimestre o anno]. <pre>SELECT date_add('hour', 9, TIMESTAMP '2022-06-17 00:00:00')</pre> Risultato di esempio: `2022-06-17 09:00:00.000000000`  | 
|  date\$1diff (unità, data, data), date\$1diff (unità, ora, ora), date\$1diff (unità, timestamp, timestamp)  |  bigint  |  Restituisce una differenza, dove l'unità è uno dei [secondo, minuto, ora, giorno, settimana, mese, trimestre o anno]. <pre>SELECT date_diff('day', DATE '2020-03-01', DATE '2020-03-02')</pre> Risultato di esempio: `1`  | 
|  parse\$1duration (stringa)  |  intervallo  |  Analizza la stringa di input per restituire un equivalente. `interval` <pre>SELECT parse_duration('42.8ms')</pre> Risultato di esempio: `0 00:00:00.042800000` <pre>SELECT typeof(parse_duration('42.8ms'))</pre> Risultato di esempio: `interval day to second`  | 
| bin (timestamp, intervallo) | timestamp |  Arrotonda il valore intero del `timestamp` parametro al multiplo più vicino del valore intero del `interval` parametro. Il significato di questo valore restituito potrebbe non essere ovvio. Viene calcolato utilizzando l'aritmetica dei numeri interi prima dividendo il numero intero del timestamp per il numero intero dell'intervallo e quindi moltiplicando il risultato per il numero intero dell'intervallo. Tenendo presente che un timestamp specifica un punto UTC come un numero di frazioni di secondo trascorse dall'epoca POSIX (1 gennaio 1970), il valore restituito raramente si allinea alle unità del calendario. Ad esempio, se si specifica un intervallo di 30 giorni, tutti i giorni trascorsi dall'epoca vengono divisi in incrementi di 30 giorni e viene restituito l'inizio dell'incremento di 30 giorni più recente, che non ha alcuna relazione con i mesi del calendario. Ecco alcuni esempi: <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>  | 
|  fa (intervallo)  |  timestamp  |  Restituisce il valore corrispondente a `interval` current\$1timestamp. <pre>SELECT ago(1d)</pre> Risultato di esempio: `2022-07-06 21:08:53.245000000`  | 
|  valori letterali a intervalli come 1h, 1d e 30m  |  intervallo  |  I valori letterali a intervalli sono utili per parse\$1duration (string). Ad esempio, `1d` è equivalente a `parse_duration('1d')`. Ciò consente l'uso dei valori letterali ovunque venga utilizzato un intervallo. Ad esempio `ago(1d)` e `bin(<timestamp>, 1m)`.  | 

Alcuni valori letterali a intervalli fungono da abbreviazione di parse\$1duration. Ad esempio,,`parse_duration('1day')`, e ogni ritorno in cui `1day` si `parse_duration('1d')` trova il tipo`1d`. `1 00:00:00.000000000` `interval day to second` Lo spazio è consentito nel formato fornito a`parse_duration`. Ad esempio, restituisce `parse_duration('1day')` anche`00:00:00.000000000`. Ma non `1 day` è un intervallo letterale.

Le unità relative a `interval day to second` sono ns, nanosecond, us, microsecond, ms, millisecond, s, second, m, minute, h, hour, d e day.

C'è anche. `interval year to month` Le unità relative all'intervallo da un anno all'altro sono y, anno e mese. Ad esempio, `SELECT 1year` restituisce`1-0`. `SELECT 12month`restituisce anche`1-0`. `SELECT 8month`ritorna`0-8`.

Sebbene l'unità di `quarter` sia disponibile anche per alcune funzioni come `date_trunc` e`date_add`, non `quarter` è disponibile come parte di un intervallo letterale.

## Formattazione e analisi
<a name="date-time-functions-formatting-parsing"></a>

Timestream for LiveAnalytics supporta le seguenti funzioni di formattazione e analisi per data e ora.


| Funzione | Tipo di dati di output | Description | 
| --- | --- | --- | 
|  date\$1format (timestamp, varchar (x))  |  varchar  |  [Per ulteriori informazioni sugli specificatori di formato usati da questa funzione, vedere \$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> Risultato di esempio: `2019-10-20 10:20:20`  | 
|  date\$1parse (varchar (x), varchar (y))  |  timestamp  |  [Per ulteriori informazioni sugli specificatori di formato usati da questa funzione, vedere \$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> Risultato di esempio: `2019-10-20 10:20:20.000000000`  | 
|  format\$1datetime (timestamp, varchar (x))  |  varchar  |  [Per ulteriori informazioni sulla stringa di formato utilizzata da questa funzione, vedere 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> Risultato di esempio: `1968-01-13 12`  | 
|  parse\$1datetime (varchar (x), varchar (y))  |  timestamp  |  [Per ulteriori informazioni sulla stringa di formato utilizzata da questa funzione, vedere 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> Risultato di esempio: `2019-12-29 18:10:00.000000000`  | 

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

Timestream for LiveAnalytics supporta le seguenti funzioni di estrazione per data e ora. La funzione di estrazione è la base per le restanti funzioni di praticità.


| Funzione | Tipo di dati di output | Description | 
| --- | --- | --- | 
|  estratto  |  bigint  |  Estrae un campo da un timestamp, dove il campo è uno dei [YEAR, QUARTER, MONTH, WEEK, DAY\$1OF\$1WEEK, DOW, DAY\$1OF\$1YEAR, DOY, YEAR\$1OF\$1WEEK, YOW, HOUR, MINUTE o SECOND]. <pre>SELECT extract(YEAR FROM '2019-10-12 23:10:34.000000000')</pre> Risultato di esempio: `2019`  | 
|  giorno (timestamp), giorno (data), giorno (intervallo da giorno a secondo)  |  bigint  |  <pre>SELECT day('2019-10-12 23:10:34.000000000')</pre> Risultato di esempio: `12`  | 
|  day\$1of\$1month (timestamp), day\$1of\$1month (data), day\$1of\$1month (intervallo da giorno a secondo)  |  bigint  |  <pre>SELECT day_of_month('2019-10-12 23:10:34.000000000')</pre> Risultato di esempio: `12`  | 
|  day\$1of\$1week (timestamp), day\$1of\$1week (data)  |  bigint  |  <pre>SELECT day_of_week('2019-10-12 23:10:34.000000000')</pre> Risultato di esempio: `6`  | 
|  day\$1of\$1year (timestamp), day\$1of\$1year (data)  |  bigint  |  <pre>SELECT day_of_year('2019-10-12 23:10:34.000000000')</pre> Risultato di esempio: `285`  | 
|  dow (timestamp), dow (data)  |  bigint  |  Alias per day\$1of\$1week  | 
|  doy (timestamp), doy (data)  |  bigint  |  Alias per day\$1of\$1year  | 
|  ora (timestamp), ora (ora), ora (intervallo da giorno a secondo)  |  bigint  |  <pre>SELECT hour('2019-10-12 23:10:34.000000000')</pre> Risultato di esempio: `23`  | 
|  millisecondo (timestamp), millisecondo (ora), millisecondo (intervallo da giorno a secondo)  |  bigint  |  <pre>SELECT millisecond('2019-10-12 23:10:34.000000000')</pre> Risultato di esempio: `0`  | 
|  minuto (timestamp), minuto (ora), minuto (intervallo da giorno a secondo)  |  bigint  |  <pre>SELECT minute('2019-10-12 23:10:34.000000000')</pre> Risultato di esempio: `10`  | 
|  mese (timestamp), mese (data), mese (intervallo da anno a mese)  |  bigint  |  <pre>SELECT month('2019-10-12 23:10:34.000000000')</pre> Risultato di esempio: `10`  | 
|  nanosecondo (timestamp), nanosecondo (ora), nanosecondo (intervallo da giorno a secondo)  |  bigint  |  <pre>SELECT nanosecond(current_timestamp)</pre> Risultato di esempio: `162000000`  | 
|  trimestre (timestamp), trimestre (data)  |  bigint  |  <pre>SELECT quarter('2019-10-12 23:10:34.000000000')</pre> Risultato di esempio: `4`  | 
|  secondo (timestamp), secondo (ora), secondo (intervallo da giorno a secondo)  |  bigint  |  <pre>SELECT second('2019-10-12 23:10:34.000000000')</pre> Risultato di esempio: `34`  | 
|  settimana (timestamp), settimana (data)  |  bigint  |  <pre>SELECT week('2019-10-12 23:10:34.000000000')</pre> Risultato di esempio: `41`  | 
|  settimana\$1del\$1anno (timestamp), settimana\$1del\$1anno (data)  |  bigint  |  Alias per settimana  | 
|  anno (timestamp), anno (data), anno (intervallo da anno a mese)  |  bigint  |  <pre>SELECT year('2019-10-12 23:10:34.000000000')</pre> Risultato di esempio: `2019`  | 
|  anno\$1di\$1settimana (timestamp), anno\$1del\$1settimana (data)  |  bigint  |  <pre>SELECT year_of_week('2019-10-12 23:10:34.000000000')</pre> Risultato di esempio: `2019`  | 
|  yow (timestamp), yow (data)  |  bigint  |  Alias per year\$1of\$1week  | 