. Funzioni di data e ora di OmniStudio

Ti trovi qui:

Funzioni di data e ora di OmniStudio

Funzioni che operano in date e orari.

Funzione OmniStudio ADDDAY
Restituisce una data e un'ora dopo aver aggiunto un numero specificato di giorni.
Funzione Omnistudio ADDMONTH
Restituisce una data e un'ora dopo aver aggiunto un numero specificato di mesi.
Funzione Omnistudio ADDYEAR
Restituisce una data e un'ora dopo aver aggiunto un numero specificato di anni.
Funzione Omnistudio AGE
Restituisce la durata in anni per una data di nascita specificata.
Funzione OmniStudio AGEON
Restituisce la durata in anni di una data di nascita specificata in una data specificata.
Funzione DATEDIFF Omnistudio
Restituisce la differenza di numero di giorni tra due date specificate come valore intero.
Funzione DATETIMETOUNIX Omnistudio
Restituisce il numero di millisecondi nell'ora UNIX per una data e un'ora specificate.
Funzione Omnistudio DAY
Restituisce il giorno di una data specificata come valore intero.
Funzione OmniStudio EOM
Restituisce la data e l'ora dell'ultimo giorno del mese per una data specificata.
Funzione FORMATDATETIME Omnistudio
Restituisce una data e un'ora come stringa in un formato e in un fuso orario specificati.
Funzione Omnistudio FORMATDATETIMEGMT
Restituisce una data e un'ora come stringa in un formato specificato e nel fuso orario GMT.
Funzione OmniStudio HOUR
Restituisce l'ora di un'ora specificata come valore intero.
Funzione Omnistudio MINUTE
Restituisce il minuto per un tempo specificato come valore intero.
Funzione MESE Omnistudio
Restituisce il mese di una data specificata come valore intero.
Funzione OmniStudio NOW
Restituisce la data e l'ora correnti in un formato specificato.
Funzione Omnistudio SECOND
Restituisce il secondo per un tempo specificato come valore intero.
Funzione TIMEDIFF Omnistudio
Restituisce la differenza di numero di millisecondi tra due tempi specificati come intero.
Funzione OmniStudio TODAY
Restituisce la data corrente.
Funzione OmniStudio UNIXTODATETIME
Restituisce la data e l'ora per un numero di secondi o millisecondi specificato nell'ora UNIX.
Funzione Omnistudio YEAR
Restituisce l'anno di una data specificata come valore intero.

Funzione OmniStudio ADDDAY

Restituisce una data e un'ora dopo aver aggiunto un numero specificato di giorni.

Se si specifica una data e un'ora, utilizzare il formato data "YYYY-MM-DD" per mantenere l'ora di input. Utilizzare il "MM/DD/YYYY" del formato di data per reimpostare l'ora su 00:00:00.

Firma

ADDDAY(date, days)

Valore restituito

Data/ora

Parametri

Parametro	Tipo di dati	Necessità	Descrizione
`date`	Data/ora	Obbligatorio	Data specificata come stringa in formato Day.js. È possibile specificare una data e un'ora.
`days`	Intero	Obbligatorio	Numero di giorni da aggiungere alla data specificata. Utilizzare un numero negativo per sottrarre giorni dalla data.

Esempio di aggiunta di giorni

Formula: ADDDAY("2025-01-01", 31)

Formula: ADDDAY("01/01/2025", 31)

Formula: ADDDAY("01/01/2025T12:00:00Z", 31)

Valore restituito: "2025-02-01T00:00:00.000Z"

Esempio di aggiunta di giorni

Formula: ADDDAY("2025-01-01T12:00:00Z", 31)

Valore restituito: "2025-02-01T12:00:00.000Z"

Esempio di sottrazione di giorni

Formula: ADDDAY("2025-01-01", -100)

Formula: ADDDAY("2025-01-01T00:00:00Z", -100)

Valore restituito: "2024-09-23T00:00:00.000Z"

Funzione Omnistudio ADDMONTH

Restituisce una data e un'ora dopo aver aggiunto un numero specificato di mesi.

Se si specifica una data e un'ora, utilizzare il formato data "YYYY-MM-DD" per mantenere l'ora di input. Utilizzare il "MM/DD/YYYY" del formato di data per reimpostare l'ora su 00:00:00.

Firma

ADDMONTH(date, months)

Valore restituito

Data/ora

Parametri

Parametro	Tipo di dati	Necessità	Descrizione
`date`	Data/ora	Obbligatorio	Data specificata come stringa in formato Day.js. È possibile specificare una data e un'ora.
`months`	Intero	Obbligatorio	Numero di mesi da aggiungere alla data specificata. Utilizzare un numero negativo per sottrarre mesi dalla data.

Esempio di aggiunta di mesi

Formula: ADDMONTH('2025-25-01', 15)

Formula: ADDMONTH("01/25/2025", 15)

Formula: ADDMONTH("01/25/2025T16:35:30Z", 15)

Valore restituito: "2026-04-25T00:00:00.000Z"

Esempio di aggiunta di mesi

Formula: ADDMONTH("2025-01-25T16:35:30Z", 15)

Valore restituito: "2026-04-25T16:35:30.000Z"

Esempio di sottrazione di mesi

Formula: ADDMONTH("01/25/2025", -15)

Formula: ADDMONTH('01/25/2025T16:35:30Z', -15)

Valore restituito: "2023-10-25T00:00:00.000Z"

Funzione Omnistudio ADDYEAR

Restituisce una data e un'ora dopo aver aggiunto un numero specificato di anni.

Se si specifica una data e un'ora, utilizzare il formato data "YYYY-MM-DD" per mantenere l'ora di input. Utilizzare il "MM/DD/YYYY" del formato di data per reimpostare l'ora su 00:00:00.

Firma

ADDYEAR(date, years)

Valore restituito

Data/ora

Parametri

Parametro	Tipo di dati	Necessità	Descrizione
`date`	Data/ora	Obbligatorio	Data specificata come stringa in formato Day.js. È possibile specificare una data e un'ora.
`years`	Intero	Obbligatorio	Numero di anni da aggiungere alla data specificata. Utilizzare un numero negativo per sottrarre anni dalla data.

Esempio di aggiunta di anni

Formula: ADDYEAR("2025-01-01", 10)

Formula: ADDYEAR("01/01/2025", 10)

Formula: ADDYEAR("01/01/2025T16:35:30", 10)

Valore restituito: "2035-01-01T00:00:00.000Z"

Esempio di aggiunta di anni

Formula: ADDYEAR("2025-01-01T16:35:30", 10)

Valore restituito: "2035-01-01T16:35:30.000Z"

Esempio di sottrazione di anni

Formula: ADDYEAR("2025-01-01", -10)

Formula: ADDYEAR("2025-01-01T00:00:00", -10)

Valore restituito: "2015-01-01T00:00:00.000Z"

Funzione Omnistudio AGE

Restituisce la durata in anni per una data di nascita specificata.

Firma

AGE(birthDate)

Valore restituito

Intero

Parametri

Parametro	Tipo di dati	Necessità	Descrizione
`birthDate`	Data/ora	Obbligatorio	Data specificata come stringa in formato Day.js. È possibile specificare una data e un'ora.

Esempio di stringa di data

Formula: AGE("02/15/2002")

Formula: AGE("2002-02-15")

Valore restituito: 23

Esempio di stringa di data e ora

Formula: AGE("2002-02-15T16:35:30")

Formula: AGE("2002-02-15T16:35:30Z")

Valore restituito: 23

Funzione OmniStudio AGEON

Restituisce la durata in anni di una data di nascita specificata in una data specificata.

La funzione calcola una durata basata solo sulle date; ignora gli orari. La funzione restituisce 0 se la date specificata è inferiore a un anno dalla birthDate o precedente.

Firma

AGEON(birthDate, date)

Valore restituito

Intero

Parametri

Parametro	Tipo di dati	Necessità	Descrizione
`birthDate`	Data/ora	Obbligatorio	Data di nascita per cui deve essere calcolata l'età. Specificare una data come stringa in formato Day.js. È possibile specificare una data e un'ora.
`date`	Data/ora	Obbligatorio	Data per cui la funzione è calcolare un'età in base alla data di nascita. Specificare una data come stringa in formato Day.js. È possibile specificare una data e un'ora.

Esempio di stringa di data e ora

Formula: AGEON("02/15/2002T16:35:30Z", "2030-02-28")

Formula: AGEON("2002-02-15", "2030-02-28T16:35:30Z")

Valore restituito: 28

Esempio di oggetto JSON

Dati di esempio:

"BirthDate": "6/25/2004T09:05:00 GMT -0500 (EDT)"
"FutureDate1": "02/28/2030",
"FutureDate2": "2030-02-28"

Formula: AGEON(%Birthdate%, %FutureDate1%)

Formula: AGEON("BirthDate%, %FutureDate2%)

Valore restituito: 25

Funzione DATEDIFF Omnistudio

Restituisce la differenza di numero di giorni tra due date specificate come valore intero.

La prima data viene sottratta dalla seconda data. Se la prima data è maggiore della seconda, la funzione restituisce un intero negativo.

Se si include un'ora, la funzione la considera nel calcolo. Se si specifica un fuso orario, la funzione lo considera nel calcolo.

Firma

DATEDIFF(firstDate, secondDate)

Valore restituito

Intero

Parametri

Parametro	Tipo di dati	Necessità	Descrizione
`firstDate`	Data	Obbligatorio	Data specificata come stringa in formato Day.js. È possibile specificare una data e un'ora.
`secondDate`	Data	Obbligatorio	Data in cui la funzione calcola la differenza di numero di giorni tra la prima data. Specificare una data come stringa in formato Day.js. È possibile specificare una data e un'ora.

Esempio di giorni positivi

Formula: DATEDIFF("02/01/2000", "2001-02-01")

Valore restituito: 366

Esempio di giorni negativi

Formula: DATEDIFF("2001-02-01", "02/01/2000")

Valore restituito: -366

Esempio di data e ora

Formula: DATEDIFF("2025-02-04T00:00:00", "2025-03-04T00:00:00")

Valore restituito: 28

Esempio di data e ora

Formula: DATEDIFF("2025-02-04T12:00:00", "2025-03-04T11:59:59")

Valore restituito: 27

Esempio di data e ora con fuso orario

Formula: DATEDIFF("2025-02-04T12:00:00-0500", "2025-03-04T11:59:59+0000")

Valore restituito: 28

Esempi di oggetti JSON

Dati di esempio:

"Account": [
  {
    "Cases": [
      {
        "Case1": {
          "CreatedDate": "2/1/2024T16:35:30 GMT -0500 (EDT)",
          "LastUpdate": "2/8/2024T09:15:00 GMT -0500 (EDT)"
        }
      },
      {
        "Case2": {
          "CreatedDate": "2/2/2025T11:05:05 GMT -0500 (EDT)",
          "LastUpdate": "2/3/2025T15:50:57 GMT -0500 (EDT)"
        }
      }
    ]
  }
]

Formula: DATEDIFF(Account:Cases:Case1:CreatedDate, Account:Cases:Case1:LastUpdate)

Valore restituito: 7

Formula: DATEDIFF(%Account:Cases:Case2:CreatedDate%, TODAY())

Valore restituito: 8

Funzione DATETIMETOUNIX Omnistudio

Restituisce il numero di millisecondi nell'ora UNIX per una data e un'ora specificate.

L'ora UNIX è il numero di secondi non bisestili trascorsi dalle 00:00:00 del 1o gennaio 1970, ora universale coordinata (UTC). UTC corrisponde all'ora media di Greenwich (GMT). Il valore viene definito epoca UNIX.

Firma

DATETIMETOUNIX(datetime)

Valore restituito

Intero

Parametri

Parametro	Tipo di dati	Necessità	Descrizione
`datetime`	Data/ora	Obbligatorio	Una data e un'ora specificate come stringa in formato Day.js. È anche possibile specificare solo una data.

Esempio di data e ora

Formula: DATETIMETOUNIX("2002-02-01T16:35:30:000Z")

Formula: DATETIMETOUNIX("2002-02-01T16:35:30:000")

Formula: DATETIMETOUNIX("2002-02-01T16:35:30")

Formula: DATETIMETOUNIX("02/01/2002T16:35:30")

Valore restituito: 1012581330000

Esempio di data e ora zero

Formula: DATETIMETOUNIX("2002-02-01")

Formula: DATETIMETOUNIX("02/01/2002")

Formula: DATETIMETOUNIX("2002-02-01T00:00:00")

Formula: DATETIMETOUNIX("02/01/2002T00:00:00")

Formula: DATETIMETOUNIX("2002-02-01T00:00:00Z")

Formula: DATETIMETOUNIX("02/01/2002T00:00:00Z")

Valore restituito: 1012521600000

Funzione Omnistudio DAY

Restituisce il giorno di una data specificata come valore intero.

Firma

DAY(date)

Valore restituito

Intero

Parametri

Parametro	Tipo di dati	Necessità	Descrizione
`date`	Data/ora	Obbligatorio	Data specificata come stringa in formato Day.js. È possibile specificare una data e un'ora.

Esempio di stringa di data

Formula: DAY("2025-01-31")

Formula: DAY("01/31/2025")

Formula: DAY("1/31/2025")

Valore restituito: 31

Esempio di oggetto JSON

Dati di esempio: "Birthdate": "2002-02-15T16:35:30 GMT -0500 (EDT)"

Formula: DAY(Birthdate)

Valore restituito: 15

Funzione OmniStudio EOM

Restituisce la data e l'ora dell'ultimo giorno del mese per una data specificata.

Firma

EOM(date)

Valore restituito

Data/ora

Parametri

Parametro	Tipo di dati	Necessità	Descrizione
`date`	Data/ora	Obbligatorio	Data specificata come stringa in formato Day.js. È possibile specificare una data e un'ora.

Esempio di data

Formula: EOM("2024-02-01")

Formula: EOM("02/01/2024")

Valore restituito: "2024-02-29T00:00:00.000Z"

Esempio di data e ora

Formula: EOM("02/01/2024T16:35:30")

Formula: EOM("02/01/2024T16:35:30Z")

Valore restituito: "2024-02-29T00:00:00.000Z"

Funzione FORMATDATETIME Omnistudio

Restituisce una data e un'ora come stringa in un formato e in un fuso orario specificati.

Il fuso orario medio di Greenwich (GMT) è lo stesso del fuso orario UTC (Coordinated Universal Time), che funge da base del fuso orario UNIX e dell'epoca UNIX.

Firma

FORMATDATETIME(datetime, format, timezone)

Valore restituito

Stringa

Parametri

Parametro	Tipo di dati	Necessità	Descrizione
`datetime`	Data/ora	Obbligatorio	Una data e un'ora specificate come stringa in formato Day.js. È possibile specificare solo una data o un'ora. Se si specifica solo una data, l'ora predefinita è `00:00:00`. Se si specifica solo un'ora, la data predefinita è `1970-01-01` (l'epoca UNIX).
`format`	Stringa	Facoltativo	Stringa che specifica il formato in cui restituire la data e l'ora. Utilizzare la notazione Java SimpleDateFormat per specificare il formato della risposta. Per impostazione predefinita, la funzione restituisce la data e l'ora nel formato `"MM/DD/YY HH:mm aaa"`.
`timezone`	Stringa	Facoltativo	Stringa che indica il fuso orario in cui restituire la data e l'ora. Per impostazione predefinita, la funzione restituisce la data e l'ora nel fuso orario del chiamante. Per utilizzare un fuso orario diverso, specificare un identificatore di fuso orario, ad esempio `America/New_York`. Per un elenco completo degli identificatori di fuso orario, vedere Informazioni sul fuso orario. Se si specifica un `fuso orario`, è necessario specificare anche un `formato`.

Esempio di data senza ora, formato o fuso orario

Formula: FORMATDATETIME("01/31/2025")

Valore restituito: "1/30/25 4:00 PM"

Esempio di data/ora senza formato o fuso orario

Formula: FORMATDATETIME("01/31/2025T12:00:00")

Valore restituito: "1/31/25 4:00 AM"

Esempio di data/ora senza fuso orario

Formula: FORMATDATETIME("01/31/2025T12:00:00", "yyyy-MM-dd'T'HH:mm:ssZ")

Valore restituito: "2025-01-31T04:00:00-0800"

Esempio di data/ora

Formula: FORMATDATETIME("01/31/2025T12:00:00", "yyyy-MM-dd'T'HH:mm:ssZ", "America/Los_Angeles")

Valore restituito: "2025-01-31T04:00:00-0800"

Esempio di data/ora

Formula: FORMATDATETIME("01/31/2025T12:00:00", "yyyy-MM-dd'T'HH:mm:ssZ", "America/New_York")

Valore restituito: "2025-01-31T07:00:00-0500"

Funzione Omnistudio FORMATDATETIMEGMT

Restituisce una data e un'ora come stringa in un formato specificato e nel fuso orario GMT.

Il fuso orario medio di Greenwich (GMT) è lo stesso del fuso orario UTC (Coordinated Universal Time), che funge da base del fuso orario UNIX e dell'epoca UNIX.

Firma

FORMATDATETIMEGMT(datetime, timezone, format)

Valore restituito

Stringa

Parametri

Parametro	Tipo di dati	Necessità	Descrizione
`datetime`	Data/ora	Obbligatorio	Una data e un'ora specificate come stringa in formato Day.js. È possibile specificare solo una data o un'ora. Se si specifica solo una data, l'ora predefinita è `00:00:00`. Se si specifica solo un'ora, la data predefinita è `1970-01-01` (l'epoca UNIX).
`timezone`	Stringa	Facoltativo	Stringa che indica il fuso orario della data e dell'ora specificate. Per impostazione predefinita, la funzione utilizza il fuso orario del chiamante. Per utilizzare un fuso orario diverso, specificare un identificatore di fuso orario, ad esempio `America/New_York`. Per un elenco completo degli identificatori di fuso orario, vedere Informazioni sul fuso orario.
`format`	Stringa	Facoltativo	Stringa che specifica il formato in cui restituire la data e l'ora. Utilizzare la notazione Java SimpleDateFormat per specificare il formato della risposta. Per impostazione predefinita, la funzione restituisce la data e l'ora nel formato `"MM/DD/YY HH:mm aaa"`. Se si specifica un `formato`, è necessario specificare anche un fuso `orario`.

Esempio di data senza ora, fuso orario o formato

Formula: FORMATDATETIMEGMT("01/31/2025")

Valore restituito: "2025-01-31T08:00:00.000Z"

Esempio di data/ora senza fuso orario o formato

Formula: FORMATDATETIMEGMT("01/31/2025T12:00:00")

Valore restituito: "2025-01-31T20:00:00.000Z"

Esempio di data/ora senza formato

Formula: FORMATDATETIMEGMT("01/31/2025T12:00:00", "America/Los_Angeles")

Valore restituito: "2025-01-31T20:00:00.000Z"

Esempio di data/ora

Formula: FORMATDATETIMEGMT("01/31/2025T12:00:00", "America/Los_Angeles", "yyyy-MM-dd'T'HH:mm:ssZ")

Valore restituito: "2025-01-31T20:00:00+0000"

Esempio di data/ora

Formula: FORMATDATETIMEGMT("01/31/2025T12:00:00", "America/New_York", "yyyy-MM-dd'T'HH:mm:ssZ")

Valore restituito: "2025-01-31T17:00:00+0000"

Funzione OmniStudio HOUR

Restituisce l'ora di un'ora specificata come valore intero.

Firma

Hour(time)

Valore restituito

Intero

Parametri

Parametro	Tipo di dati	Necessità	Descrizione
`time`	Data/ora	Obbligatorio	Ora specificata come stringa in formato Day.js. È possibile specificare una data e un'ora.

Esempio di orario

Formula: HOUR("08:00:00")

Formula: HOUR("T08:00:00")

Valore restituito: 8

Esempio di data e ora

Formula: HOUR("2004-02-01T08:00:00Z")

Formula: HOUR("02/01/2004T08:00:00Z")

Valore restituito: 8

Esempio di oggetto JSON

Dati di esempio: "DateField": "2003-02-01T16:35:30Z"

Formula: HOUR(%DateField%)

Valore restituito: 16

Funzione Omnistudio MINUTE

Restituisce il minuto per un tempo specificato come valore intero.

Firma

MINUTE(time)

Valore restituito

Intero

Parametri

Parametro	Tipo di dati	Necessità	Descrizione
`time`	Data/ora	Obbligatorio	Ora specificata come stringa in formato Day.js. È possibile specificare una data e un'ora.

Esempio di orario

Formula: MINUTE("08:17:00")

Formula: MINUTE("T08:17:00")

Valore restituito: 17

Esempio di data e ora

Formula: MINUTE("2004-02-01T08:17:00Z")

Formula: MINUTE("02/01/2004T08:17:00Z")

Valore restituito: 17

Esempio di oggetto JSON

Dati di esempio: "DateField": "2003-02-01T16:35:30Z"

Formula: MINUTE(DateField)

Valore restituito: 35

Funzione MESE Omnistudio

Restituisce il mese di una data specificata come valore intero.

Firma

MONTH(date)

Valore restituito

Intero

Parametri

Parametro	Tipo di dati	Necessità	Descrizione
`date`	Data/ora	Obbligatorio	Data specificata come stringa in formato Day.js. È possibile specificare una data e un'ora.

Esempio di stringa di data

Formula: MONTH("2025-01-01")

Formula: MONTH("01/01/2025")

Formula: MONTH("1/1/2025")

Valore restituito: 1

Esempio di oggetto JSON

Dati di esempio: "Birthdate": "2007-06-25T08:35:00Z"

Formula: MONTH(%Birthdate%)

Valore restituito: 6

Funzione OmniStudio NOW

Restituisce la data e l'ora correnti in un formato specificato.

Per impostazione predefinita, la funzione restituisce la data e l'ora in UTC (Coordinated Universal Time). UTC corrisponde all'ora media di Greenwich (GMT). Utilizzare la variabile di ambiente $Vlocity.NOW per applicare il fuso orario dell'utente o dell'organizzazione.

È possibile utilizzare la funzione NOW con altre funzioni per specificare una data e un'ora relative alla data e all'ora correnti.

Firma

NOW(format)

Valore restituito

Data/ora

Parametri

Parametro	Tipo di dati	Necessità	Descrizione
`format`	Stringa	Facoltativo	Stringa di formato in notazione SimpleDateFormat che specifica il formato della risposta. Per impostazione predefinita, la funzione restituisce la data e l'ora nel formato `"yyyy-MM-dd'T'HH:mm:ss:SSS"` UTC (GMT).

Esempio di nessun formato

Formula: NOW()

Valore restituito: "2025-03-08T22:01:46.684Z"