make_timestamp Funktionen

Gäller för:markerad ja Databricks SQL markerad ja Databricks Runtime

Skapar en tidsstämpel från yearfälten , month, day, hour, min, secoch timezone .

Syntax

make_timestamp(year, month, day, hour, min, sec [, timezone] )

Argumenten

  • year: Ett INTEGER-uttryck som utvärderar till ett värde från 1 till 9999.
  • month: Ett INTEGER-uttryck som utvärderar till ett värde från 1 (januari) till 12 (december).
  • day: Ett INTEGER-uttryck som utvärderar till ett värde från 1 till 31.
  • hour: Ett INTEGER-uttryck som utvärderar till ett värde mellan 0 och 23.
  • min: Ett INTEGER-uttryck som utvärderar till ett värde mellan 0 och 59.
  • sec: Ett numeriskt uttryck som utvärderar till ett värde mellan 0 och 60.
  • timezone: Ett valfritt STRING-uttryck som utvärderar till en giltig tidszonssträng. Till exempel: CET, UTC.

Returer

en tidsstämpel.

Om något av argumenten ligger utanför gränserna i Databricks SQL blir NULLresultatet . I Databricks Runtime, om något av argumenten ligger utanför gränserna, genererar Azure Databricks DATETIME_FIELD_OUT_OF_BOUNDS såvida inte spark.sql.ansi.enabled är false, i vilket fall funktionen returnerar NULL. Om sec är 60 tolkas det som 0 och en minut läggs till resultatet.

Om sec har ett bråkvärde som inte kan representeras med mikrosekunders precision, genererar Azure Databricks INVALID_FRACTION_OF_SECOND.

Vanliga felvillkor

Exempel

> SELECT make_timestamp(2014, 12, 28, 6, 30, 45.887);
 2014-12-28 06:30:45.887
> SELECT make_timestamp(2014, 12, 28, 6, 30, 45.887, 'CET');
 2014-12-27 21:30:45.887
> SELECT make_timestamp(2019, 6, 30, 23, 59, 60);
 2019-07-01 00:00:00
> SELECT make_timestamp(2019, 13, 1, 10, 11, 12, 'PST');
 NULL
> SELECT make_timestamp(NULL, 7, 22, 15, 30, 0);
 NULL

-- In DBR with ANSI mode, out-of-bounds fields raise an error.
> SELECT make_timestamp(2024, 13, 1, 0, 0, 0);
  Error: DATETIME_FIELD_OUT_OF_BOUNDS
  • Last updated on