X++-kørselsfunktioner for dato

I denne artikel beskrives funktionerne til kørsel af dato og klokkeslæt.

dayName

Henter navnet på den ugedag, der svarer til et tal.

str dayName(int number)

Parametre

Returværdi

Den ugedag, der er angivet af talparameteren.

Bemærkninger

De gyldige værdier for talparameteren er 1 til 7. Mandag repræsenteres af 1, tirsdag med 2 og søndag med 7.

Eksempel

static void dayNameExample(Args _arg)
{
    str s = dayName(1);
    print "First day of the week's name is " + s;
    pause;
}

dayOfMth

Beregner antallet af dagen i måneden for den angivne dato.

int dayOfMth(date date)

Parametre

Returværdi

Et heltal mellem 1 og 31, der angiver dagen i måneden for den angivne dato.

Bemærkninger

dayOfMth(31\12\2001) // returns 31.

Eksempel

static void dayOfMthExample(Args _arg)
{
    date d = today();
    int i = dayOfMth(d);

    print "Today's day of the month is " + int2Str(i);
    pause;
}

dayOfWk

Beregner antallet af dage i ugen for den angivne dato.

int dayOfWk(date date)

Parametre

Returværdi

Antallet af den angivne dag i ugen.

Eksempel

static void dayOfWkExample(Args _arg)
{
    date d = today();
    int i = dayOfWk(d);

    print "Today's day of the week is " + int2Str(i);
    pause;
}

dayOfYr

Beregner antallet af dage mellem den 1. januar og den angivne dato.

int dayOfYr(date _date)

Parametre

Returværdi

Antallet af dage mellem den 1. januar og den angivne dato inklusive.

Bemærkninger

1. januar er 1, og 31. december er enten 365 eller 366 , afhængigt af om året er et skudår.

Eksempel

static void dayOfYrExample(Args _arg)
{
    date d = today();
    int i = dayOfYr(d);

    print "Today's day of the year is " + int2Str(i);
    pause;
}

endMth

Beregner den sidste dato i måneden for den angivne dato.

date endMth(date date)

Parametre

Returværdi

Datoværdien for den sidste dag i den angivne måned.

Bemærkninger

endMth(02\2\1988); //Returns the date 29\2\1988 because 1988 is a leap year.
endMth(02\2\1989); //Returns the date 28\2\1989.

mkDate

Opretter en dato baseret på tre heltal, der angiver henholdsvis dag, måned og år.

date mkDate(int day, int month, int year)

Parametre

Returværdi

En datoværdi , der er baseret på værdierne for parametrene dag, måned og år .

Bemærkninger

Hvis datoen ikke er gyldig, returnerer denne metode en 0-dato (nul, 1/1/1900).

Eksempel

static void mkDateExample(Args _arg)
{
    date d;
    
    // Returns the date 01\01\2005.
    d = mkDate(1, 1, 2005);
    print d;
    pause;
}

mthName

Henter navnet på den angivne måned

str monthName(int number)

Parametre

Returværdi

Navnet på den angivne måned.

Bemærkninger

De gyldige værdier for talparameteren er 1 til 12. Januar repræsenteres af 1 . og december med 12.

Eksempel

static void mthNameExample(Args _arg)
{
    // MthName(6) returns the text string "June".
    str s = mthName(6);

    print "Month name is " + s;
    pause;
}

mthOfYr

Henter månedens nummer i året for den angivne dato.

int mthOfYr(date date)

Parametre

Returværdi

Månedens nummer i året for den måned, der repræsenteres af datoparameteren .

Eksempel

static void mthOfYrExample(Args _arg)
{
    int i = mthOfYr(today());

    print "The number of the month in today's date is " + int2Str(i);
    pause;
}

nextMth

Henter den dato i den følgende måned, der svarer mest til den angivne dato.

date nextMth(date date)

Parametre

Returværdi

Det nærmeste match til den angivne dato, der findes i den næste måned.

Bemærkninger

nextMth(29\2\1996); //returns 29/03/1996.
nextMth(31\1\1996); //returns 2921996, because 1996 is a leap year.

Eksempel

static void nextMthExample(Args _arg)
{
    date d = nextMth(today());

    print "Closest date next month is "
        + date2Str(d, 2, 2, -1, 2, -1, 4);
    pause;
}

nextQtr

Henter den dato i det følgende kvartal, der svarer mest til den angivne dato.

date nextQtr(date date)

Parametre

Returværdi

Det nærmeste match til den angivne dato, som funktionen finder i det næste kvartal.

Bemærkninger

NextQtr(31\1\1998) returnerer f.eks. 30\4\1998.

Eksempel

static void nextQtrExample(Args _arg)
{
    date d = nextQtr(today());

    print "Closest date next quarter is "
        + date2Str(d, 2, 2, -1, 2, -1, 4);
    pause;
}

nextYr

Henter den dato i det følgende år, der svarer mest til den angivne dato.

date nextYr(date date)

Parametre

Returværdi

Det nærmeste match til den angivne dato, der blev fundet i det følgende år.

Bemærkninger

Nextyr(29\2\1998) returnerer f.eks. 28\2\1999.

Eksempel

static void nextYrExample(Args _arg)
{
    date d = nextYr(today());

    print "Closest date next year is "
        + date2Str(d, 2, 2, -1, 2, -1, 4);
    pause;
}

prevMth

Henter den dato i den forrige måned, der svarer mest til den angivne dato.

date prevMth(date date)

Parametre

Returværdi

Det nærmeste match til den angivne dato, der blev fundet i den forrige måned.

Bemærkninger

prevMth(31\3\1996); // Returns the date 29/02/1996 because 1996 is a leap year.
prevMth(28\2\1998); // Returns the date 28/01/1998.

prevQtr

Henter den dato i forrige kvartal, der svarer mest til den angivne dato.

date prevQtr(date date)

Parametre

Returværdi

Det nærmeste match til den angivne dato, der blev fundet i det forrige kvartal.

Bemærkninger

prevQtr(30\4\1998); // Returns the date 30/01/1998.
prevQtr(29\5\1996); // Returns the date 29/02/1996, because 1996 is a leap year.

prevYr

Henter den dato i det forrige år, der svarer mest til den angivne dato.

date prevYr(date date)

Parametre

Returværdi

Det nærmeste match til den angivne dato, som systemet finder i det forrige år.

Bemærkninger

prevYr(29\2\1996); //Returns the date 28/02/1995 because 1996 is a leap year.
prevYr(28\2\1998); //Returns the date 28/02/1997.

systemDateHent

Henter sessionsdatoen, hvis den er angivet.

date systemDateGet()

Returværdi

Sessionsdatoen, hvis den er angivet. ellers systemdatoen.

Bemærkninger

Brug Sessionsdato og -klokkeslæt i menuen Funktioner til at åbne siden Sessionsdato og -klokkeslæt . Brug denne side til at angive sessionsdatoen. Når systemet har registreret denne sæthandling, returnerer efterfølgende kald til funktionen systemDateGet sessionsdatoen. Funktionen today returnerer systemdatoen. Denne funktion understøtter ikke tidszoner.

Eksempel

I følgende eksempel vises datoen i vinduet Infolog.

static void Job_systemDateGet(Args _arg)
{
    info( date2Str(
        systemDateGet(),        // X++ language function.
        321,                    // 321 = ymd
        DateDay::Digits2,
        DateSeparator::Hyphen,  // separator1
        DateMonth::Digits2,
        DateSeparator::Hyphen,  // separator2
        DateYear::Digits4
    )
);
/*********** Actual Infolog output
Message (03:46:00 pm)
2012-04-16
***********/
}

systemDateSet

Ændrer systemdatoen.

date systemDateSet(date _date)

Parametre

Returværdi

Den nye systemdato.

Bemærkninger

Denne funktion påvirker ikke sessionsdatoen. Denne metode ændrer datoen, men klokkeslættet er angivet til 0 (nul).

Eksempel

I følgende eksempel angives systemdatoen til dags dato.

static void systemDateSetExample(Args _arg)
{
    date d = today();
    d = systemDateSet(d);
    print d;
}

timeNow

Henter det aktuelle systemklokkeslæt.

int timeNow()

Returværdi

Det antal sekunder, der er gået siden midnat.

Eksempel

static void timeNowExample(Args _arg)
{
    int i = timeNow();

    print "The number of seconds since midnight is " + int2Str(i);
    pause;
}

I dag

Henter den aktuelle dato i systemet.

date today()

Returværdi

Den aktuelle dato.

Eksempel

static void todayExample(Args _arg)
{
    date d = today();
    
    print "Today's date is " + date2Str(d, 0, 2, -1, 2, -1, 4);
    pause;
}

wkOfYr

Beregner den uge i året, hvor en dato falder i henhold til ISO 8601-specifikationen.

int wkOfYr(date _date)

Parametre

Returværdi

Ugens sekvensnummer, som parameteren _date findes i.

Eksempel

I følgende kodeeksempel sammenlignes funktionen wkOfYr med metoden Global::weekOfYear . Funktionen og metoden giver forskellige resultater.

// X++ job, under AOT > Jobs.
static void WeekTests3Job(Args _args)
{
    int weekNum, i;
    date dateTest;
    str sMessages[];

    //---------------------------------------------
    sMessages[1] = "----- #1.  For Sunday, January 5, 2003 -----";
    dateTest = 512003; // DayMonthYear  format.
    weekNum = wkOfYr(dateTest);
    sMessages[2] = int2str(weekNum) + " = wkOfYr funtion";
    weekNum = Global::weekOfYear(dateTest);
    sMessages[3] = int2str(weekNum) + " = Global::weekOfYear method";
    
    //---------------------------------------------
    sMessages[4] = " ";
    sMessages[5] = "----- #2.  For Wednesday, August 20, 2003 -----";
    dateTest = 2082003;
    weekNum = wkOfYr(dateTest);
    sMessages[6] = int2str(weekNum) + " = wkOfYr funtion";
    weekNum = Global::weekOfYear(dateTest);
    sMessages[7] = int2str(weekNum) + " = Global::weekOfYear method";
    
    //---------------------------------------------
    sMessages[8] = " ";
    sMessages[9] = "----- #3.  For Sunday, December 28, 2003 -----";
    dateTest = 28122003;
    weekNum = wkOfYr(dateTest);
    sMessages[10] = int2str(weekNum) + " = wkOfYr funtion";
    weekNum = Global::weekOfYear(dateTest);
    sMessages[11] = int2str(weekNum) + " = Global::weekOfYear method";
    
    for (i=1; i<= 11; i++)
    {
        Global::info(sMessages[i]);
    }
}

I det forrige eksempel sendes følgende oplysninger til infologgen til visning. Outputtet viser, at der er forskelle mellem wkOfYr og Global::weekOfYear.

Message (01:59:13 pm) ----- 
#1. For Sunday, January 5, 2003 ----- 1 = wkOfYr function 2 = Global::weekOfYear method ----- 
#2. For Wednesday, August 20, 2003 ----- 34 = wkOfYr function 34 = Global::weekOfYear method ----- 
#3. For Sunday, December 28, 2003 ----- 52 = wkOfYr function 1 = Global::weekOfYear method

år

Henter året fra en datoværdi .

int year(date _date)

Parametre

Returværdi

Året for den angivne dato.

Bemærkninger

year(0221998); //Returns the value 1998.