Funzioni di data e ora (DataStage®)
È possibile utilizzare le funzioni di data e ora per eseguire diverse operazioni su date e ore nello stage Transformer.
Le funzioni che specificano date, ore o timestamp negli argomenti utilizzano stringhe con formati specifici:
- Per una data, il formato è%aaaa-%mm-%gg
- Per un'ora, il formato è%hh:%n:%ss. Se esteso per includere microsecondi, il formato è%hh:%nn:%ss.x dove x indica il numero di secondi decimali.
- Per una data / ora, il formato è il formato data seguito dal formato ora.
Le funzioni che hanno i giorni della settimana nell'argomento assumono una stringa che specifica il giorno della settimana. Il giorno viene specificato come abbreviazione di tre lettere o come nome completo. Ad esempio, le stringhe "thu" e "thursday" sono entrambe valide.
Le seguenti funzioni si trovano nella categoria Data & ora dell'editor di espressioni. Le parentesi indicano che un argomento è facoltativo. Gli esempi mostrano la funzione come viene visualizzata in un campo Derivazione nello stage Transformer.
- CurrentDate
- Restituisce la data in cui viene eseguito il lavoro.
- Input: non applicabile
- Output: data (data)
- Esempi. Utilizzare questa funzione per aggiungere una nuova colonna che contiene la data ai dati di output dello stage Transformer.
CurrentDate()
- CurrentTime
- Restituisce l'ora di sistema corrente.
- Input: non applicabile
- Output: ora (ora)
- Esempi. Utilizzare questa funzione per aggiungere una nuova colonna che contiene l'orario per i dati di output dello stage Transformer. Se non si specifica l'argomento tra parentesi quadre, la funzione restituisce un campo ora senza microsecondi.
Facoltativo: se si specifica l'argomento stringa che è uguale a "support_microsecond", la funzione restituisce un campo ora con microsecondi.CurrentTime()CurrentTime("support_microsecond")
- CurrentTimeMS
- Restituisce l'ora di sistema corrente, inclusi microsecondi.
- Input: non applicabile
- Output: ora (ora)
- Esempi. Utilizzare questa funzione per aggiungere una nuova colonna che contiene l'orario per i dati di output dello stage Transformer. È necessario impostare il campo Esteso nei metadati di colonna su Microsecondi per contenere l'intero tempo.
CurrentTimeMS()
- CurrentTimestamp
- Restituisce una data/ora che fornisce la data e l'ora in cui viene eseguito il lavoro.
- Input: non applicabile
- Output: data/ora (timestamp)
- Esempi. Utilizzare questa funzione per aggiungere una nuova colonna che contiene la data/ora ai dati di output dello stage Transformer.
CurrentTimestamp()
- CurrentTimestampMS
- Restituisce una data/ora, inclusi i microsecondi, che fornisce la data e l'ora in cui viene eseguito il lavoro.
- Input: non applicabile
- Output: data/ora (timestamp)
- Esempi. Utilizzare questa funzione per aggiungere una nuova colonna che contiene la data/ora per i dati di output dello stage Transformer. È necessario impostare il campo Esteso nei metadati della colonna su Microsecondi per contenere la data / ora completa.
CurrentTimestampMS()
- ConvertTimeZone
- Converte un timestamp con fuso orario in un fuso orario diverso.
- Input: anno del fuso orario da convertire in (int), mese del fuso orario da convertire in (int), giorno del fuso orario da convertire in (int), ora del fuso orario da convertire in (int), minuti del fuso orario da convertire in (int), secondi del fuso orario da convertire in (int), acronimo del fuso orario a tre lettere da convertire da (string), acronimo del fuso orario a tre lettere da convertire in (string)
- Output: nuovo fuso orario (stringa)
- Esempi. Se mylink.currentYear contiene il numero intero 2021, la seguente funzione restituisce una stringa data/ora che utilizza il nuovo fuso orario, "2021-09-30 04:02:03".
ConvertTimeZone(mylink.currentYear, 9, 30, 1, 2, 3, "PST", "EST")
- DateFromDaysSince
- Restituisce una stringa di data aggiungendo un numero intero a una data di baseline. Il numero intero può essere negativo per restituire una data precedente rispetto alla data di baseline. Questa funzione è obsoleta in IBM® InfoSphere® Information Server, Versione 11.3. Utilizzare la funzione DateFromDaysSince2 .
- Input: numero (int32), [ stringa_data_base (stringa)]
- Output: data (data)
- Esempi. Se mylink.myintcol contiene l'intero 18250 e mylink.mydatecol contiene la data 1958-08-18, le tre seguenti funzioni sono equivalenti e restituiscono la data 2008-08-05:
Se mylink.mynegintcol contiene il numero intero -1 e mylink.mydatecol contiene la data 1958-08-18, allora le tre funzioni seguenti sono equivalenti e restituiscono la data 1958-08-17:DateFromDaysSince(18250,"1958-08-18") DateFromDaysSince(mylink.myintcol,"1958-08-18") DateFromDaysSince(mylink.myintcol,mylink.mydatecol)DateFromDaysSince(-1,"1958-08-18") DateFromDaysSince(mylink.mynegintcol,"1958-08-18") DateFromDaysSince(mylink.mynegintcol,mylink.mydatecol)
- DateFromDaysSince2
- Restituisce un oggetto data aggiungendo un numero intero a una data di baseline. Il numero intero può essere negativo per restituire una data precedente rispetto alla data di baseline.
- Input: number (int32), [ baseline_date_object (date)]
- Output: data (data)
- Esempi. Se mylink.myintcol contiene l'intero 18250 e mylink.mydatecol contiene la data 1958-08-18, le tre seguenti funzioni sono equivalenti e restituiscono la data 2008-08-05:
Se mylink.mynegintcol contiene il numero intero -1 e mylink.mydatecol contiene la data 1958-08-18, allora le tre funzioni seguenti sono equivalenti e restituiscono la data 1958-08-17:DateFromDaysSince2(18250,"1958-08-18") DateFromDaysSince2(mylink.myintcol,"1958-08-18") DateFromDaysSince2(mylink.myintcol,mylink.mydatecol)DateFromDaysSince2(-1,"1958-08-18") DateFromDaysSince2(mylink.mynegintcol,"1958-08-18") DateFromDaysSince2(mylink.mynegintcol,mylink.mydatecol)
- DateFromComponents
- Restituisce una data a partire dagli anni, mesi e giorno del mese indicati come tre valori separati.
- Input: anni (int32), mesi (int32), giorno del mese (int32)
- Output: data (data)
- Esempi. Se mylink.yearcol contiene il valore 2010, mylink.monthcol contiene il valore 12 e mylink.dayofmonthcol contiene il valore 2, le due seguenti funzioni sono equivalenti e restituiscono la data 2010-12-02.
DateFromComponents(2010, 12, 2) DateFromComponents(mylink.yearcol, mylink.monthcol, mylink.dayofmonthcol)
- DateFromJulianDay
- Restituisce una data a partire dal numero del giorno giuliano fornito.
- Ingresso : julianday ( uint32 )
- Output: data (data)
- Esempi. Se mylink.myjulcol contiene il valore 2454614, le due seguenti funzioni sono equivalenti e restituiscono la data 2008-05-27.
DateFromJulianDay(2454614) DateFromJulianDay(mylink.myjulcol)
- DateOffsetByComponents
- Restituisce la data indicata, con offset applicati dall'offset di anno, mese e giorno del mese forniti, come tre valori separati. I valori di offset possono essere positivi, zero o negativi.
- Input : basedate (data), year_offset ( int32 ), month_offset ( int32 ), dayofmonth_offset ( int32 )
- Output: data (data)
- Esempi. Se mylink.basedate contiene 2011-08-18 e mylink.yearos contiene il valore 2, mylink.monthos contiene il valore 0 e mylink.dayofmonthosol contiene il valore 0, le seguenti due funzioni sono equivalenti e restituiscono la data 2013-08-18.
DateOffsetByComponents("2011-08-18", 2, 0, 0) DateOffsetByComponents(mylink.basedate, mylink.yearos, mylink.monthos, mylink.dayofmonthos) - Se mylink.basedate contiene 2011-08-18 e mylink.yearos contiene il valore -2, mylink.monthos contiene il valore 0 e mylink.dayofmonthosol contiene il valore 0, allora le due funzioni seguenti sono equivalenti e restituiscono la data 2009-08-18.
DateOffsetByComponents("2011-08-18", -2, 0, 0) DateOffsetByComponents(mylink.basedate, mylink.yearos, mylink.monthos, mylink.dayofmonthos)
- DaysSinceFromDate
- Restituisce il numero di giorni dalla data di origine alla data specificata. Questa funzione è obsoleta in IBM InfoSphere Information Serverversione 11.3. Utilizzare la funzione DaysSinceFromDate2 .
- Input : data_data (data), stringa_data_fonte (stringa)
- Output : days_since ( int32 )
- Esempi. Se mylink.mysourcedate contiene la data 1958-08-18 e mylink.mygivendate contiene la data 2008-08-18, le due seguenti funzioni sono equivalenti e restituiscono il valore intero 18263.
DaysSinceFromDate(mylink.mygivendate, mylink.mysourcedate) DaysSinceFromDate("2008-08-18","1958-08-18")
- DaysSinceFromDate2
- Restituisce il numero di giorni dalla data di origine alla data specificata.
- Input : data_data (data), oggetto_data_fonte (data)
- Output : days_since ( int32 )
- Esempi. Se mylink.mysourcedate contiene la data 1958-08-18 e mylink.mygivendate contiene la data 2008-08-18, le due seguenti funzioni sono equivalenti e restituiscono il valore intero 18263.
DaysSinceFromDate2(mylink.mygivendate, mylink.mysourcedate) DaysSinceFromDate2("2008-08-18","1958-08-18")
- DaysInMonth
- Restituisce il numero di giorni del mese indicato nella data base.
- Input: basedate (data)
- Output : daysinmonth ( int32 )
- Esempi. Se mylink.mysourcedate contiene la data 1958-08-18, le due seguenti funzioni sono equivalenti e restituiscono il valore intero 31.
DaysInMonth(mylink.mysourcedate) DaysInMonth("1958-08-18")
- DaysInYear
- Restituisce il numero di giorni nell'anno nella data di base indicata.
- Input: basedate (data)
- Uscita : daysinyearh ( int32 )
- Esempi. Se mylink.mysourcedate contiene la data 2012-08-18, le due seguenti funzioni sono equivalenti e restituiscono il valore intero 366.
Se mylink.mysourcedate contiene la data 2011-08-18, le due seguenti funzioni sono equivalenti e restituiscono il valore intero 365.DaysInYear(mylink.mysourcedate) DaysInYear("2012-08-18")DaysInYear(mylink.mysourcedate) DaysInYear("2011-08-18")
- DateOffsetByDays
- Restituisce l'offset di data in base al numero di giorni indicato. Il valore di offset può essere positivo, zero o negativo.
- Input : basedate (data), dayoffset ( int32 )
- Output: data (data)
- Esempi. Se mylink.basedate contiene 2011-08-18 e mylink.dayoffset contiene il valore 2, le due seguenti funzioni sono equivalenti e restituiscono la data 2011-08-20.
DateOffsetByDays("2011-08-18", 2) DateOffsetByDays(mylink.basedate, mylink.dayoffset) - Se mylink.basedate contiene 2011-08-18 e mylink.dayoffset contiene il valore -31, le due funzioni seguenti sono equivalenti e restituiscono la data 2011-07-18.
DateOffsetByDays("2011-08-18", -31) DateOffsetByDays(mylink.basedate, mylink.dayoffset)
- HoursFromTime
- Restituisce la parte ore di un orario.
- Input: ora (ora)
- Output: ore (int8)
- Esempi. Se mylink.mytime contiene l'ora 22:30:00, le due seguenti funzioni sono equivalenti e restituiscono il valore intero 22.
HoursFromTime(mylink.mytime) HoursFromTime("22:30:00")
- JulianDayFromDate
- Restituisce un numero di giorno giuliano dalla data indicata.
- Input: data (data)
- Uscita : julianday ( int32 )
- Esempi. Se mylink.mydate contiene la data 2008-05-27, le due seguenti funzioni sono equivalenti e restituiscono il valore 2454614.
JulianDayFromDate("2008–05–27") JulianDayFromDate(mylink.mydate)
- MicroSecondsFromTime
- Restituisce la parte microsecondi di un orario.
- Input: ora (ora)
- Output: microsecondi (int32)
- Esempi. Se mylink.mytime contiene l'ora 22:30:00.32, la seguente funzione restituisce il valore 320000:
MicroSecondsFromTime(mylink.mytime)
- MidnightSecondsFromTime
- Restituisce il numero di secondi dalla mezzanotte fino all'ora indicata.
- Input: ora (ora)
- Output: secondi (int8)
- Esempi. Se mylink.mytime contiene l'ora 00:30:52, le due seguenti funzioni sono equivalenti e restituiscono il valore 1852:
MidnightSecondsFromTime("00:30:52") MidnightSecondsFromTime(mylink.mytime)
- MinutesFromTime
- Restituisce la parte minuti di un orario.
- Input: ora (ora)
- Output: minuti (int8)
- Esempi. Se mylink.mytime contiene l'ora 22:30:52, le seguenti due funzioni sono equivalenti e restituiscono il valore 30:
MinutesFromTime("22:30:52") MinutesFromTime(mylink.mytime)
- MonthDayFromDate
- Restituisce il giorno del mese a partire dalla data indicata.
- Input: data (data)
- Output: giorno (int8)
- Esempi. Se mylink.mydate contiene la data 2008-08-18, le due seguenti funzioni sono equivalenti e restituiscono il valore 18:
MonthDayFromDate("2008-08-18") MonthDayFromDate(mylink.mydate)
- MonthFromDate
- Restituisce il numero del mese dalla data indicata.
- Input: data (data)
- Uscita : numero_mese ( int8 )
- Esempi. Se mylink.mydate contiene la data 2008-08-18, le due seguenti funzioni sono equivalenti e restituiscono il valore 8:
MonthFromDate("2008-08-18") MonthDayDate(mylink.mydate)
- NextWeekdayFromDate
- Restituisce la data del giorno della settimana specificato subito dopo la data di origine. Il giorno della settimana è specificato come nome completo, ad esempio thursday (giovedì), o come abbreviazione su tre lettere, ad esempio thu.
- Input : sourcedate (data), day_of_week (stringa)
- Output: data (data)
- Esempi. Se mylink.mysourcedate contiene la data 2008-08-18 e il giorno della settimana specificato è giovedì, le due seguenti funzioni sono equivalenti e restituiscono il valore 2008-08-21:
NextWeekdayFromDate("2008-08-18", "thursday") NextWeekdayFromDate(mylink.mysourcedate, "thu")
- NthWeekdayFromDate
- Restituisce la data dell'offset del giorno della settimana specificato in base al numero di settimane specificato a partire dalla data di origine. Il giorno della settimana è specificato come nome completo, ad esempio thursday (giovedì), o come abbreviazione su tre lettere, ad esempio thu. I valori di offset possono essere positivi, negativi o zero.
- Input : basedate (data), day_of_week (stringa), week_offset ( int32 )
- Output: data (data)
- Esempi. Se mylink.mydate contiene la data 2009-08-18 e Giovedì viene specificato con un offset di 1, le due seguenti funzioni sono equivalenti e restituiscono il valore 2009-08-20:
Viene restituita la prima ricorrenza di giovedì. Nell'esempio precedente, il giovedì cade nella stessa settimana della data 2009-08-18. La data 2009-08-18 è un martedì.NthWeekdayFromDate("2009-08-18", "thursday", 1) NthWeekdayFromDate(mylink.mydate, "thu", 1)Se mylink.mydate contiene la data 2009-08-18 e giovedì è specificato con un offset di -2, allora le due funzioni seguenti sono equivalenti e restituiscono il valore 2009-08-06:
Viene restituita la ricorrenza di giovedì che è passata di due giovedì.NthWeekdayFromDate("2009-08-18", "thursday", -2) NthWeekdayFromDate(mylink.mydate, "thu", -2)
- PreviousWeekdayFromDate
- Restituisce la data del giorno della settimana specificato subito prima della data di origine. Il giorno della settimana è specificato come nome completo, ad esempio thursday (giovedì), o come abbreviazione su tre lettere, ad esempio thu.
- Input : sourcedate (data), day_of_week (stringa)
- Output: data (data)
- Esempi. Se mylink.mysourcedate contiene la data 2008-08-18 e viene specificato Giovedì, le due seguenti funzioni sono equivalenti e restituiscono il valore 2008-08-14:
PreviousWeekdayFromDate("2008-08-18", "thursday") PreviousWeekdayFromDate(mylink.mysourcedate, "thu")
- SecondsFromTime
- Restituisce la parte secondi di un orario.
- Input: ora (ora)
- Output: secondi (dfloat)
- Esempi. Se mylink.mytime contiene l'ora 22:30:52, le due seguenti funzioni sono equivalenti e restituiscono il valore 52:
SecondsFromTime("22:30:52") SecondsFromTime(mylink.mytime)
- SecondsSinceFromTimestamp
- Restituisce il numero di secondi tra due stringhe di data/ora. Questa funzione è obsoleta in IBM InfoSphere Information Serverversione 11.3. Utilizzare la funzione SecondsSinceFromTimestamp2 .
- Input: timestamp (timestamp), timestamp_base_string (string)
- Output: secondi (dfloat)
- Esempi. Se mylink.mytimestamp contiene la data/ora 2008-08-18 22:30:52 e mylink.mytimestamp_base contiene la data/ora 2008-08-19 22:30:52, le seguenti due funzioni sono equivalenti e restituiscono il valore -86400:
SecondsSinceFromTimestamp("2008–08–18 22:30:52","2008–08–19 22:30:52") SecondsSinceFromTimestamp(mylink.mytimestamp, mylink.mytimestamp_base)
- SecondsSinceFromTimestamp2
- Restituisce il numero di secondi tra due oggetti data/ora.
- Input: timestamp (timestamp), timestamp_base_object (timestamp)
- Output: secondi (dfloat)
- Esempi. Se mylink.mytimestamp contiene la data/ora 2008-08-18 22:30:52 e mylink.mytimestamp_base contiene la data/ora 2008-08-19 22:30:52, le seguenti due funzioni sono equivalenti e restituiscono il valore -86400:
SecondsSinceFromTimestamp2("2008–08–18 22:30:52","2008–08–19 22:30:52") SecondsSinceFromTimestamp2(mylink.mytimestamp, mylink.mytimestamp_base)
- TimeDate
- Restituisce l'ora e la data di sistema come stringa formattata.
- Input: non applicabile
- Output: data e ora del sistema (stringa)
- Esempi. Se il lavoro è stato eseguito all'indirizzo 4.21 il 20 giugno 2008, la funzione seguente restituisce la stringa
16:21:48 20 giu 2008
.TimeDate()
- TimeFromComponents
- Restituisce un orario in base alle ore, minuti, secondi e microsecondi indicate, fornite come quattro valori separati.
- Input: ore (int32), minuti (int32), secondi (int32), microsecondi (int32)
- Output: ora (data)
- Esempi. Se mylink.hourcol contiene il valore 10, mylink.mincol contiene il valore 12, mylink.seccol contiene il valore 2 e mylink.mseccol contiene 0, le due seguenti funzioni sono equivalenti e restituiscono l'ora 10:12:02.0:
TimeFromComponents(10, 12, 2, 0) TimeFromComponents(mylink.hourcol, mylink.mincol, mylink.seccol, mylink.mseccol)
- TimeFromMidnightSeconds
- Restituisce l'orario in base al numero di secondi a partire dalla mezzanotte.
- Input: secondi (dfloat)
- Output: ora (ora)
- Esempi. Se mylink.mymidnightseconds contiene il valore 240, allora le due seguenti funzioni sono equivalenti e restituiscono il valore 00:04:00:
TimeFromMidnightSeconds("240") TimeFromMidnightSeconds(mylink.mymidnightseconds)
- TimeOffsetByComponents
- Restituisce l'ora, con gli offset applicati a partire dall'ora base con offset ora, offset minuto e offset secondo, forniti come valori separati. L'offset di secondi può includere secondi parziali.
- Input : basetime (ora), hour_offset ( int32 ), minute_offset ( int32 ), second_offset (dfloat)
- Output: ora (ora)
- Esempi. Se mylink.basetime contiene 14:05:29 e mylink.houros contiene il valore 2, mylink.minos contiene il valore 0 e mylink.dayofmonthosol contiene il valore 20, le due funzioni seguenti sono equivalenti e restituiscono l'ora 16:05:49.
TimeOffsetByComponents("14:05:29", 2, 0, 20) TimeOffsetByComponents(mylink.basetime, mylink.houros, mylink.minos, mylink.secos)
- TimeOffsetBySeconds
- Restituisce l'ora, con gli offset applicati a partire dall'ora base con offset di secondi. L'offset di secondi può includere secondi parziali.
- Input: basetime (ora), second_offset (dfloat)
- Output: ora (ora)
- Esempi. Se mylink.basetime contiene 14:05:29.30 e mylink.secos contiene il valore 2,5, le due funzioni seguenti sono equivalenti e restituiscono il tempo 14:05:31.80.
TimeOffsetByComponents("14:05:29.30", 2.5) TimeOffsetByComponents(mylink.basetime, mylink.secos)
- TimestampFromDateTime
- Restituisce una data/ora a partire dalla data e ora indicate.
- Input: data (data), ora (ora)
- Output: data/ora (timestamp)
- Esempi. Se mylink.mydate contiene la data 2008-08-18 e mylink.mytime contiene l'ora 22:30:52, le due seguenti funzioni sono equivalenti e restituiscono la data/ora 2008-08-18 22:30:52:
TimestampFromDateTime("2008–08–18","22:30:52") TimestampFromDateTime(mylink.mydate,mylink.mytime)
- TimestampFromSecondsSince
- Restituisce una data/ora derivata dal numero di secondi dalla stringa data/ora base. Questa funzione è obsoleta in IBM InfoSphere Information Serverversione 11.3. Utilizzare la funzione TimestampFromSecondsSince2 .
- Input: secondi (stringa), [ base_timestamp_string (stringa)]
- Output: data/ora (timestamp)
- Esempi. Se mylink.myseconds contiene il valore 2563 e mylink.timestamp_base contiene la data/ora 2008-08-18 22:30:52, le due seguenti funzioni sono equivalenti e restituiscono la data / ora 2008-08-18 23:13:35:
TimestampFromSecondsSince("2563","2008–08–18 22:30:52") TimestampFromSecondsSince(mylink.myseconds,mylink.timestamp_base)
- TimestampFromSecondsSince2
- Restituisce una data/ora derivata dal numero di secondi dell'oggetto data/ora base.
- Input: secondi (stringa), [ base_timestamp_object (data/ora)]
- Output: data/ora (timestamp)
- Esempi. Se mylink.myseconds contiene il valore 2563 e mylink.timestamp_base contiene la data/ora 2008-08-18 22:30:52, le due seguenti funzioni sono equivalenti e restituiscono la data / ora 2008-08-18 23:13:35:
TimestampFromSecondsSince2("2563","2008–08–18 22:30:52") TimestampFromSecondsSince2(mylink.myseconds,mylink.timestamp_base)
- TimestampFromTimet
- Restituisce una data/ora a partire dal valore stringa time_t UNIX indicato.
- Input: stringa_tabella (int32)
- Output: data/ora
- Esempi. Se mylink.mytimet contiene il valore 1234567890, le due seguenti funzioni sono equivalenti e restituiscono la data / ora 2009-02-13 23:31:30:
TimestampFromTimet("1234567890") TimestampFromTimet(mylink.mytimet)
- TimestampFromTime2
- Restituisce una data/ora a partire dagli oggetti ora e data/ora. Il valore nell'oggetto ora sovrascrive il valore ora nell'oggetto data/ora in modo che venga utilizzata solo la parte data della data/ora.
- Input: ora (ora), data/ora (data/ora)
- Output: data/ora (timestamp)
- Esempi. Se mylink.mytime contiene l'ora 12:03:22 e mylink.mytimestamp contiene l'ora 2008-08-18 22:30:52, le due seguenti funzioni sono equivalenti e restituiscono l'ora 2008-08-18 12:03:22:
TimestampFromTime2("12:03:22", "2008–08–18 22:30:52") TimestampFromTime2(mylink.mytime,mylink.mytimestamp)
- TimestampOffsetByComponents
- Restituisce la data/'ora, con gli offset applicati a partire dalla data/ora base con offset anno, offset mese, offset giorno, offset ora, offset minuto e offset secondo, forniti come valori separati. L'offset di secondi può includere microsecondi.
- Input : basetimestamp (timestamp), year_offset ( int32 ), month_offset ( int32 ), dayofmonth_offset ( int32 ), hour_offset ( int32 ), minute_offset ( int32 ), second_offset (dfloat)
- Output: data/ora (timestamp)
- Esempi. Se mylink.basetimestamp contiene 2009-08-18 14:05:29 e mylink.yearos contiene 0, mylink.monthos contiene il valore 2, mylink.dayos contiene il valore -4, mylink.houros contiene il valore 2, mylink.minos contiene il valore 0, mylink.secos contiene il valore 20, le due funzioni seguenti sono equivalenti, e restituiscono la data/ora 2009-10-14 16:05:49.
TimestampOffsetByComponents("2009-08-18 14:05:29", 0, 2, -4, 2, 0, 20) TimestampOffsetByComponents(mylink.basetimestamp, mylink.houros, mylink.minos, mylink.secos)
- TimestampOffsetBySeconds
- Restituisce la data/ora, con gli offset applicati a partire dalla data/ora base con offset di secondi. L'offset di secondi può includere microsecondi.
- Input : basetimestamp (timestamp), second_offset (dfloat)
- Output: data/ora (timestamp)
- Esempi. Se mylink.basetimestamp contiene 2009-08-18 14:05:29 e mylink.secos contiene il valore 32760, le due seguenti funzioni sono equivalenti e restituiscono la data / ora 2009-08-18 23:11:29:
TimeOffsetBySeconds("2009-08-18 14:05:29", 32760) TimeOffsetBySeconds (mylink.basetimestamp, mylink.secos)
- TimetFromTimestamp
- Restituisce un valore time_t UNIX a partire dalla data/ora fornita.
- Input: data/ora (timestamp)
- Uscita : timet ( int32 )
- Esempi. Se mylink.mytimestamp contiene il valore 2009-02-13 23:31:30, le due seguenti funzioni sono equivalenti e restituiscono il valore 1234567890:
TimestampFromTimet("2009–02–13 23:31:30") TimestampFromTimet(mylink.mytimestamp)
- WeekdayFromDate
- Restituisce il numero di giorno della settimana a partire dalla data indicata. giorno_origine facoltativamente specifica il giorno che viene considerato il primo nella settimana ed è domenica per impostazione predefinita.
- Input: date (date), [ origin_day (int8)]
- Output: giorno (int8)
- Esempi. Se mylink.mydate contiene la data 2008-08-18, le due seguenti funzioni sono equivalenti e restituiscono il valore 1:
Se mylink.mydate contiene la data 2008-08-18 e mylink.origin_day contiene sabato, le due seguenti funzioni sono equivalenti e restituiscono il valore 2:WeekdayFromDate("2008-08-18") WeekdayFromDate(mylink.mydate)WeekdayFromDate("2008-08-18","saturday") WeekdayFromDate(mylink.mydate,mylink.origin_day)
- YeardayFromDate
- Restituisce il numero di giorno dell'anno a partire dalla data indicata.
- Input: data (data)
- Output: giorno (int16)
- Esempi. Se mylink.mydate contiene la data 2008-08-18, le due seguenti funzioni sono equivalenti e restituiscono il valore 231:
YeardayFromDate("2008-08-18") YeardayFromDate(mylink.mydate)
- YearFromDate
- Restituisce l'anno a partire dalla data indicata.
- Input: data (data)
- Output: anno (int16)
- Esempi. Se mylink.mydate contiene la data 2008-08-18, le due seguenti funzioni sono equivalenti e restituiscono il valore 2008:
YearFromDate("2008-08-18") YearFromDate(mylink.mydate)
- YearweekFromDate
- Restituisce il numero di settimana nell'anno a partire dalla data indicata.
- Input: data (data)
- Output: settimana (int16)
- Esempi. Se mylink.mydate contiene la data 2008-08-18, le due seguenti funzioni sono equivalenti e restituiscono il valore 33:
YearweekFromDate("2008-08-18") YearweekFromDate(mylink.mydate)