Datum- en tijdfuncties in Adobe Workfront Fusion

Toegangsvereisten

U moet de volgende toegang hebben om de functionaliteit in dit artikel te kunnen gebruiken:

Voor meer detail over de informatie in deze lijst, zie vereisten van de Toegang in de documentatie van Workfront.

Voor informatie over Adobe Workfront Fusion vergunningen, zie Adobe Workfront Fusion vergunningen.

Variabelen

now

tijdstempel

Functies

addSeconds (date; number)

Retourneert een nieuwe datum als gevolg van het toevoegen van een bepaald aantal seconden aan een datum. Voer een negatief getal in om seconden af te trekken.

addMinutes (date; number) addminutes-date-number

Retourneert een nieuwe datum als gevolg van het toevoegen van een bepaald aantal minuten aan een datum. Voer een negatief getal in om minuten af te trekken.

addHours (date; number) addhours-date-number

Retourneert een nieuwe datum als gevolg van het toevoegen van een bepaald aantal uren aan een datum. Voer een negatief getal in om het aantal uren af te trekken.

addDays (date; number) adddays-date-number

Retourneert een nieuwe datum als gevolg van het toevoegen van een bepaald aantal dagen aan een datum. Voer een negatief getal in om dagen af te trekken.

addMonths (date; number)

Retourneert een nieuwe datum als gevolg van het toevoegen van een bepaald aantal maanden aan een datum. Voer een negatief getal in om maanden af te trekken.

addYears (date; number)

Retourneert een nieuwe datum als gevolg van het toevoegen van een bepaald aantal jaren aan een datum. Voer een negatief getal in om jaren af te trekken.

setSecond (date; number)

Deze functie retourneert een nieuwe datum met de seconden die in parameters worden opgegeven.

Geef een getal op tussen 0 en 59. Als het getal zich buiten dat bereik bevindt, retourneert de functie een seconde vanaf de vorige minuut (voor een negatief getal) of een volgende minuut (voor een positief getal).

Als u een aantal buiten de waaier moet specificeren, adviseren wij dat u ​ addSeconds gebruikt, zoals hierboven beschreven in de sectie addSeconds (datum; aantal).

setMinute (date; number)

Deze functie retourneert een nieuwe datum met de minuten die in parameters zijn opgegeven.

Geef een getal op tussen 0 en 59. Als het getal zich buiten dat bereik bevindt, retourneert de functie een minuut vanaf het vorige uur (voor een negatief getal) of het volgende uur (voor een positief getal).

Als u een aantal buiten de waaier moet specificeren, adviseren wij dat u addMinutes, zoals hierboven beschreven in addMinutes (datum; aantal)gebruikt.

setHour (date; number)

Deze functie retourneert een nieuwe datum met het uur dat in parameters is opgegeven.

Geef een getal op tussen 0 en 23. Als het getal zich buiten dit bereik bevindt, retourneert de functie een uur vanaf de vorige dag (voor een negatief getal) of volgende dag (voor een positief getal).

Als u een aantal buiten de waaier moet specificeren, adviseren wij dat u addHours, zoals hierboven beschreven in addHours (datum; aantal)gebruikt.

setDay (date; number/name of the day in English)

Deze functie retourneert een nieuwe datum met de dag die in parameters wordt opgegeven.

U kunt deze functie gebruiken om de dag van de week in te stellen, met zondag als 1 en zaterdag als 7. Als u een getal tussen 1 en 7 opgeeft, valt de resulterende datum binnen de huidige week (zondag tot zaterdag). Als het getal zich buiten dat bereik bevindt, retourneert de functie een dag vanaf de vorige week (voor een negatief getal) of volgende week (voor een positief getal).

Als u een aantal buiten de waaier moet specificeren, adviseren wij dat u addDays gebruikt, zoals hierboven beschreven in addDays (datum; aantal).

setDate (date; number)

Deze functie retourneert een nieuwe datum met de dag van de maand die in parameters is opgegeven.

Geef een getal op tussen 1 en 31. Als het getal zich buiten dit bereik bevindt, retourneert de functie een dag vanaf de vorige maand (voor een negatief getal) of de volgende maand (voor een positief getal).

setMonth (date; number/name of the month in English)

Deze functie retourneert een nieuwe datum met de maand die in parameters is opgegeven.

Geef een getal op tussen 1 en 12. Als het getal zich buiten dit bereik bevindt, retourneert de functie de maand in het voorgaande jaar (voor een negatief getal) of het daaropvolgende jaar (voor een positief getal).

setYear (date; number)

Retourneert een nieuwe datum met het jaar dat in parameters is opgegeven.

formatDate (date; format; [timezone])

Gebruik deze functie wanneer u een Date-waarde hebt, zoals 12-10-2021 20:30 , die u wilt opmaken als een Text-waarde, zoals Dec 10, 2021 8:30 PM .

Dit is bijvoorbeeld handig wanneer u de datumnotatie van een app of webservice wilt wijzigen in die van een verbonden app of webservice in hetzelfde scenario.

Voor meer informatie, zie Datumen Tekstin de artikel gegevenstypes van het Punt in de Fusie van Adobe Workfront.

Parameters

Wanneer een ander type is opgegeven, wordt typeafgedwongen. Voor meer informatie, zie Druk van het Type in Adobe Workfront Fusion.

Retourwaarde en type

De functie formatDate retourneert een tekstrepresentatie van de opgegeven waarde Date volgens de opgegeven indeling en tijdzone. Het gegevenstype is Text.

INFO

Voorbeelden: Scenario en timezone van het Web werden allebei geplaatst aan Europe/Prague in deze voorbeelden.

• formatDate(1. Date created;MM/DD/YYYY)

  Returns 10/01/2018

• formatDate(1. Date created; YYYY-MM-DD hh:mm A)

  Returns 2018-10-01 09:32 AM

• formatDate(1. Date created;DD.MM.YYYY HH:mm;UTC)

  Retourneert 01.10.2018 07:32

• formatDate(now;DD.MM.YYYY HH:mm)

  Retourneert 19.03.2019 15:30

parseDate (text; format; [timezone])

Gebruik deze functie wanneer u een tekstwaarde hebt die een datum vertegenwoordigt (zoals 12-10-2019 20:30 of Aug 18, 2019 10:00 AM) en u deze wilt omzetten (parseren) in een Date-waarde (een binaire machineleesbare representatie). Voor meer informatie, zie Datumen Tekstin de artikel gegevenstypes van het Punt in Adobe Workfront Fusion.

Parameters

De tweede kolom geeft het verwachte type aan. Wanneer een ander type is opgegeven, wordt typeafgedwongen. Voor meer informatie, zie Druk van het Type in Adobe Workfront Fusion.

Wanneer een ander type is opgegeven, wordt typeafgedwongen. Voor meer informatie, zie Druk van het Type in Adobe Workfront Fusion.

Retourwaarde en type

Deze functie converteert een tekstreeks naar een datum op basis van de notatie en tijdzone die u opgeeft. Het gegevenstype van de waarde is Date.

dateDifference (Date1; Date2; Unit)

Retourneert een getal dat het verschil in de twee datums vertegenwoordigt, uitgedrukt in de opgegeven eenheid.

Date2 wordt afgetrokken van Date1.

Gebruik een van de volgende tijdwaarden voor de parameter unit :

Als er geen eenheid is opgegeven, retourneert de functie het verschil in milliseconden.

Aanvullende voorbeelden

Hoe wordt de n-de dag van de week in de maand berekend

Deze sectie is aangepast voor Workfront Fusion op de Exceljet -webpagina waarin wordt uitgelegd hoe u de negende dag van de week in een maand kunt ophalen.

Als u een datum wilt berekenen die overeenkomt met de n-de dag van de week in de maand (bijvoorbeeld, eerste dinsdag, derde vrijdag, enzovoort), kunt u de volgende formule gebruiken:

{{addDays(setDate(1.date; 1); 1.n * 7 - formatDate(addDays(setDate(1.date; 1); "-" + 1.dow); "E"))}}

De formule bevat de volgende items:

Als u bijvoorbeeld slechts één specifiek geval wilt berekenen, kunt u de items 1.n en 2.dow in de formule vervangen door de corresponderende getallen. Voor de tweede woensdag in de huidige maand, zou u de volgende waarden gebruiken:

Uitleg:

Hoe te om dagen tussen data te berekenen

Een mogelijkheid is om de volgende expressie te gebruiken:

{{round((2.value - 1.value) / 1000 / 60 / 60 / 24)}}

Laatste dag/milliseconde van maand berekenen

Wanneer u een datumwaaier, bijvoorbeeld in een onderzoeksmodule specificeert, als de waaier de volledige vorige maand als gesloten interval (het interval overspant dat beide zijn limietpunten omvat), moet u de laatste dag van de maand berekenen.

2019-09-01 ≤ D ≤ 2019-09-30

In de onderstaande formule wordt een manier getoond om de laatste dag van de voorgaande maand te berekenen:

{{addDays(setDate(now; 1); -1)}}

In sommige gevallen moet u niet alleen de laatste dag van de maand berekenen, maar ook letterlijk de laatste milliseconde:

2019-09-01T00 :00: 00.000Z ≤ D ≤ 2019-09-30T23 :59: 59.999Z

Deze formule toont één manier hoe te om laatste milliseconden van de vorige maand te berekenen:

{{parseDate(parseDate(formatDate(now; "YYYYMM01"); "YYYYMMDD"; "UTC") - 1; "x")}}

Laat het UTC-argument weg als u het resultaat nodig hebt om de tijdzoneinstelling te gebruiken:

{{parseDate(parseDate(formatDate(now; "YYYYMM01"); "YYYYMMDD") - 1; "x")}}

Het is echter aan te raden in plaats daarvan halfopen interval te gebruiken (het interval waarbij een van de limietpunten wordt uitgesloten), waarbij in plaats daarvan de eerste dag van de volgende maand wordt opgegeven en de operator "kleiner of gelijk aan" als volgt wordt vervangen door "kleiner dan":

2019-09-01 ≤ D < 2019-10-01

2019-09-01T00:00:00.000Z ≤ D < 2019-10-01T00:00:00.000Z