ClickHouse/docs/fr/query_language/functions/date_time_functions.md
2020-03-30 15:48:55 +03:00

20 KiB
Raw Blame History

machine_translated
true

Fonctions pour travailler avec des dates et des heures

Support des fuseaux horaires

Toutes les fonctions pour travailler avec la date et l'heure qui ont une logique d'utilisation pour le fuseau horaire peut accepter un second fuseau horaire argument. Exemple: Asie / Ekaterinbourg. Dans ce cas, ils utilisent le fuseau horaire spécifié au lieu du fuseau horaire local (par défaut).

SELECT
    toDateTime('2016-06-15 23:00:00') AS time,
    toDate(time) AS date_local,
    toDate(time, 'Asia/Yekaterinburg') AS date_yekat,
    toString(time, 'US/Samoa') AS time_samoa
┌────────────────time─┬─date_local─┬─date_yekat─┬─time_samoa──────────┐
│ 2016-06-15 23:00:00 │ 2016-06-15 │ 2016-06-16 │ 2016-06-15 09:00:00 │
└─────────────────────┴────────────┴────────────┴─────────────────────┘

Seuls les fuseaux horaires qui diffèrent de L'UTC par un nombre entier d'heures sont pris en charge.

toTimeZone

Convertir l'heure ou la date et de l'heure au fuseau horaire spécifié.

toYear

Convertit une date ou une date avec l'heure en un numéro UInt16 contenant le numéro d'année (AD).

toQuarter

Convertit une date ou une date avec l'heure en un numéro UInt8 contenant le numéro de trimestre.

toMonth

Convertit une date ou une date avec l'heure en un numéro UInt8 contenant le numéro de mois (1-12).

toDayOfYear

Convertit une date ou une date avec l'heure en un numéro UInt16 contenant le numéro du jour de l'année (1-366).

toDayOfMonth

Convertit une date ou une date avec le temps à un UInt8 contenant le numéro du jour du mois (1-31).

toDayOfWeek

Convertit une date ou une date avec l'heure en un numéro UInt8 contenant le numéro du jour de la semaine (lundi est 1, et dimanche est 7).

toHour

Convertit une date avec l'heure en un nombre UInt8 contenant le numéro de l'heure dans l'Heure de 24 heures (0-23). This function assumes that if clocks are moved ahead, it is by one hour and occurs at 2 a.m., and if clocks are moved back, it is by one hour and occurs at 3 a.m. (which is not always true even in Moscow the clocks were twice changed at a different time).

toMinute

Convertit une date avec l'heure en un numéro UInt8 contenant le numéro de la minute de l'heure (0-59).

toseconde

Convertit une date avec l'heure en un nombre UInt8 contenant le numéro de la seconde dans la minute (0-59). Les secondes intercalaires ne sont pas comptabilisés.

toUnixTimestamp

Pour L'argument DateTime: convertit la valeur en sa représentation numérique interne (horodatage Unix). For String argument: analyse datetime from string en fonction du fuseau horaire (second argument optionnel, le fuseau horaire du serveur est utilisé par défaut) et renvoie l'horodatage unix correspondant. Pour L'argument Date: le comportement n'est pas spécifié.

Syntaxe

toUnixTimestamp(datetime)
toUnixTimestamp(str, [timezone])

Valeur renvoyée

  • Renvoie l'horodatage unix.

Type: UInt32.

Exemple

Requête:

SELECT toUnixTimestamp('2017-11-05 08:07:47', 'Asia/Tokyo') AS unix_timestamp

Résultat:

┌─unix_timestamp─┐
│     1509836867 │
└────────────────┘

toStartOfYear

Arrondit une date ou une date avec l'heure jusqu'au premier jour de l'année. Renvoie la date.

toStartOfISOYear

Arrondit une date ou une date avec l'heure jusqu'au premier jour de L'année ISO. Renvoie la date.

toStartOfQuarter

Arrondit une date ou une date avec l'heure jusqu'au premier jour du trimestre. Le premier jour du trimestre, soit le 1er janvier, 1er avril, 1er juillet ou 1er octobre. Renvoie la date.

toStartOfMonth

Arrondit une date ou une date avec l'heure jusqu'au premier jour du mois. Renvoie la date.

!!! attention "Attention" Le comportement de l'analyse des dates incorrectes est spécifique à l'implémentation. ClickHouse peut renvoyer la date zéro, lancer une exception ou faire “natural” débordement.

toMonday

Arrondit une date ou une date avec l'heure au lundi le plus proche. Renvoie la date.

toStartOfWeek (t [, mode])

Arrondit une date ou une date avec l'heure au dimanche ou au lundi le plus proche par mode. Renvoie la date. L'argument mode fonctionne exactement comme l'argument mode de toWeek(). Pour la syntaxe à argument unique, une valeur de mode de 0 est utilisée.

toStartOfDay

Arrondit une date avec le temps au début de la journée.

toStartOfHour

Arrondit une date avec le temps au début de l " heure.

toStartOfMinute

Arrondit une date avec le temps au début de la minute.

toStartOfFiveMinute

Arrondit à une date avec l'heure de début de l'intervalle de cinq minutes.

toStartOfTenMinutes

Arrondit une date avec le temps au début de l " intervalle de dix minutes.

toStartOfFifteenMinutes

Arrondit la date avec le temps jusqu'au début de l'intervalle de quinze minutes.

toStartOfInterval(time_or_data, intervalle x Unité [, time_zone])

Ceci est une généralisation d'autres fonctions nommées toStartOf*. Exemple, toStartOfInterval(t, INTERVAL 1 year) renvoie la même chose que toStartOfYear(t), toStartOfInterval(t, INTERVAL 1 month) renvoie la même chose que toStartOfMonth(t), toStartOfInterval(t, INTERVAL 1 day) renvoie la même chose que toStartOfDay(t), toStartOfInterval(t, INTERVAL 15 minute) renvoie la même chose que toStartOfFifteenMinutes(t) etc.

toTime

Convertit une date avec l'heure en une certaine date fixe, tout en préservant l'heure.

toRelativeYearNum

Convertit une date avec l'heure ou la date, le numéro de l'année, à partir d'un certain point fixe dans le passé.

toRelativeQuarterNum

Convertit une date avec l'heure ou la date au numéro du trimestre, à partir d'un certain point fixe dans le passé.

toRelativeMonthNum

Convertit une date avec l'heure ou la date au numéro du mois, à partir d'un certain point fixe dans le passé.

toRelativeWeekNum

Convertit une date avec l'heure ou la date, le numéro de la semaine, à partir d'un certain point fixe dans le passé.

toRelativeDayNum

Convertit une date avec l'heure ou la date au numéro du jour, à partir d'un certain point fixe dans le passé.

toRelativeHourNum

Convertit une date avec l'heure ou la date au nombre de l'heure, à partir d'un certain point fixe dans le passé.

toRelativeMinuteNum

Convertit une date avec l'heure ou la date au numéro de la minute, à partir d'un certain point fixe dans le passé.

toRelativeSecondNum

Convertit une date avec l'heure ou la date au numéro de la seconde, à partir d'un certain point fixe dans le passé.

toISOYear

Convertit une date ou une date avec l'heure en un numéro UInt16 contenant le numéro D'année ISO.

toISOWeek

Convertit une date ou une date avec l'heure en un numéro UInt8 contenant le numéro de semaine ISO.

toWeek (date [, mode])

Cette fonction renvoie le numéro de semaine pour date ou datetime. La forme à deux arguments de toWeek() vous permet de spécifier si la semaine commence le dimanche ou le lundi et si la valeur de retour doit être comprise entre 0 et 53 ou entre 1 et 53. Si l'argument mode est omis, le mode par défaut est 0. toISOWeek()est une fonction de compatibilité équivalente à toWeek(date,3). Le tableau suivant décrit le fonctionnement de l'argument mode.

Mode Premier jour de la semaine Gamme Week 1 is the first week …
0 Dimanche 0-53 avec un dimanche cette année
1 Lundi 0-53 avec 4 jours ou plus cette année
2 Dimanche 1-53 avec un dimanche cette année
3 Lundi 1-53 avec 4 jours ou plus cette année
4 Dimanche 0-53 avec 4 jours ou plus cette année
5 Lundi 0-53 avec un lundi cette année
6 Dimanche 1-53 avec 4 jours ou plus cette année
7 Lundi 1-53 avec un lundi cette année
8 Dimanche 1-53 contient Janvier 1
9 Lundi 1-53 contient Janvier 1

Pour les valeurs de mode avec une signification de “with 4 or more days this year,” les semaines sont numérotées selon ISO 8601: 1988:

  • Si la semaine contenant Janvier 1 A 4 jours ou plus dans la nouvelle année, il est Semaine 1.

  • Sinon, c'est la dernière semaine de l'année précédente, et la semaine prochaine est la semaine 1.

Pour les valeurs de mode avec une signification de “contains January 1”, la semaine contient Janvier 1 est Semaine 1. Peu importe combien de jours dans la nouvelle année la semaine contenait, même si elle contenait seulement un jour.

toWeek(date, [, mode][, Timezone])

Paramètre

  • date Date or DateTime.
  • mode Optional parameter, Range of values is [0,9], default is 0.
  • Timezone Optional parameter, it behaves like any other conversion function.

Exemple

SELECT toDate('2016-12-27') AS date, toWeek(date) AS week0, toWeek(date,1) AS week1, toWeek(date,9) AS week9;
┌───────date─┬─week0─┬─week1─┬─week9─┐
│ 2016-12-27 │    52 │    52 │     1 │
└────────────┴───────┴───────┴───────┘

toYearWeek (date [, mode])

Retourne l'année et la semaine pour une date. L'année dans le résultat peut être différente de l'année dans l'argument date pour la première et la dernière semaine de l'année.

L'argument mode fonctionne exactement comme l'argument mode de toWeek(). Pour la syntaxe à argument unique, une valeur de mode de 0 est utilisée.

toISOYear()est une fonction de compatibilité équivalente à intDiv(toYearWeek(date,3),100).

Exemple

SELECT toDate('2016-12-27') AS date, toYearWeek(date) AS yearWeek0, toYearWeek(date,1) AS yearWeek1, toYearWeek(date,9) AS yearWeek9;
┌───────date─┬─yearWeek0─┬─yearWeek1─┬─yearWeek9─┐
│ 2016-12-27 │    201652 │    201652 │    201701 │
└────────────┴───────────┴───────────┴───────────┘

maintenant

Accepte zéro argument et renvoie l'heure actuelle à l'un des moments de l'exécution de la requête. Cette fonction renvoie une constante, même si la requête a pris beaucoup de temps à compléter.

aujourd'

Accepte zéro argument et renvoie la date actuelle à l'un des moments de l'exécution de la requête. Le même que toDate(now()).

hier

Accepte zéro argument et renvoie la date d'hier à l'un des moments de l'exécution de la requête. Le même que today() - 1.

l'horaire de diffusion

Arrondit le temps à la demi-heure. Cette fonction est spécifique à Yandex.Metrica, car une demi-heure est le temps minimum pour diviser une session en deux sessions si une balise de suivi affiche les pages vues consécutives d'un seul utilisateur qui diffèrent dans le temps de strictement plus que ce montant. Cela signifie que les tuples (l'ID de balise, l'ID utilisateur et l'intervalle de temps) peuvent être utilisés pour rechercher les pages vues incluses dans la session correspondante.

toYYYYMM

Convertit une date ou une date avec l'heure en un numéro UInt32 contenant le numéro d'année et de mois (AAAA * 100 + MM).

toYYYYMMDD

Convertit une date ou une date avec l'heure en un numéro UInt32 contenant le numéro d'année et de mois (AAAA * 10000 + MM * 100 + JJ).

toYYYYMMDDhhmmss

Convertit une date ou une date avec l'heure en un numéro UInt64 contenant le numéro d'année et de mois (AAAA * 10000000000 + MM * 100000000 + DD * 1000000 + hh * 10000 + mm * 100 + ss).

addYears, addMonths, addWeeks, addDays, addHours, addMinutes, addSeconds, addQuarters

Fonction ajoute une date / DateTime intervalle à une Date / DateTime, puis retourner la Date / DateTime. Exemple:

WITH
    toDate('2018-01-01') AS date,
    toDateTime('2018-01-01 00:00:00') AS date_time
SELECT
    addYears(date, 1) AS add_years_with_date,
    addYears(date_time, 1) AS add_years_with_date_time
┌─add_years_with_date─┬─add_years_with_date_time─┐
│          2019-01-01 │      2019-01-01 00:00:00 │
└─────────────────────┴──────────────────────────┘

subtractYears, subtractMonths, subtractWeeks, subtractDays, subtractHours, subtractMinutes, subtractSeconds, subtractQuarters

Fonction soustrayez un intervalle de Date / DateTime à une Date / DateTime, puis renvoyez la Date / DateTime. Exemple:

WITH
    toDate('2019-01-01') AS date,
    toDateTime('2019-01-01 00:00:00') AS date_time
SELECT
    subtractYears(date, 1) AS subtract_years_with_date,
    subtractYears(date_time, 1) AS subtract_years_with_date_time
┌─subtract_years_with_date─┬─subtract_years_with_date_time─┐
│               2018-01-01 │           2018-01-01 00:00:00 │
└──────────────────────────┴───────────────────────────────┘

dateDiff

Renvoie la différence entre deux valeurs Date ou DateTime.

Syntaxe

dateDiff('unit', startdate, enddate, [timezone])

Paramètre

  • unit — Time unit, in which the returned value is expressed. Chaîne.

    Supported values:
    
    | unit   |
    | ------ |
    |second  |
    |minute  |
    |hour    |
    |day     |
    |week    |
    |month   |
    |quarter |
    |year    |
    
  • startdate — The first time value to compare. Date ou DateTime.

  • enddate — The second time value to compare. Date ou DateTime.

  • timezone — Optional parameter. If specified, it is applied to both startdate et enddate. Si non spécifié, fuseaux horaires de l' startdate et enddate sont utilisés. Si elles ne sont pas identiques, le résultat n'est pas spécifié.

Valeur renvoyée

Différence entre startdate et enddate exprimé en unit.

Type: int.

Exemple

Requête:

SELECT dateDiff('hour', toDateTime('2018-01-01 22:00:00'), toDateTime('2018-01-02 23:00:00'));

Résultat:

┌─dateDiff('hour', toDateTime('2018-01-01 22:00:00'), toDateTime('2018-01-02 23:00:00'))─┐
│                                                                                     25 │
└────────────────────────────────────────────────────────────────────────────────────────┘

intervalle de temps (StartTime, Duration, [, Size])

Pour un intervalle de temps commençant à StartTime et de poursuivre pour Duration secondes, il renvoie un tableau de moments dans le temps, composé de points de cet intervalle arrondis vers le bas à la Size en quelques secondes. Size est un paramètre optionnel: une constante UInt32, définie sur 1800 par défaut. Exemple, timeSlots(toDateTime('2012-01-01 12:20:00'), 600) = [toDateTime('2012-01-01 12:00:00'), toDateTime('2012-01-01 12:30:00')]. Ceci est nécessaire pour rechercher les pages vues dans la session correspondante.

formatDateTime(Heure, Format [, fuseau horaire])

Function formats a Time according given Format string. N.B.: Format is a constant expression, e.g. you can not have multiple formats for single result column.

Modificateurs pris en charge pour le Format: (“Example” colonne affiche le résultat de formatage pour le temps 2018-01-02 22:33:44)

Modificateur Description Exemple
%C année divisée par 100 et tronquée en entier (00-99) 20
%d jour du mois, zero-rembourré (01-31) 02
%D Date courte MM / JJ / AA, équivalente à %m / % d / % y 01/02/18
% e jour du mois, rembourré dans l'espace ( 1-31) 2
%F date courte AAAA-MM-JJ, équivalente à % Y - % m - % d 2018-01-02
%H heure en format 24h (00-23) 22
%I heure en format 12h (01-12) 10
%j les jours de l'année (001-366) 002
%m mois en nombre décimal (01-12) 01
%M minute (00-59) 33
%et caractère de nouvelle ligne (")
%p Désignation AM ou PM PM
%R 24 heures HH:MM temps, équivalent à %H: % M 22:33
%S deuxième (00-59) 44
% t horizontal-caractère de tabulation (')
%T Format d'heure ISO 8601 (HH:MM:SS), équivalent à %H: % M:%S 22:33:44
% u ISO 8601 jour de la semaine comme numéro avec Lundi comme 1 (1-7) 2
%V Numéro de semaine ISO 8601 (01-53) 01
%W jour de la semaine comme un nombre décimal avec dimanche comme 0 (0-6) 2
% y Année, deux derniers chiffres (00-99) 18
%Y An 2018
%% signe %

Article Original