Fungsi runtime tanggal X++

Nota

Grup minat komunitas sekarang telah dipindahkan dari Yammer ke Microsoft Viva Engage. Untuk bergabung dengan komunitas Viva Engage dan ambil bagian dalam diskusi terbaru, isi formulir Minta akses ke Keuangan dan Operasi Viva Libatkan Komunitas dan pilih komunitas yang ingin Anda gabungkan.

Artikel ini menjelaskan fungsi run-time tanggal.

dayName

Mengambil nama hari dalam seminggu yang sesuai dengan angka.

str dayName(int number)

Parameter-parameternya

Pengaturan	Description
nomor/angka	Jumlah hari dalam seminggu.

Mengembalikan nilai

Hari dalam seminggu yang ditentukan oleh parameter angka.

Komentar

Nilai yang valid untuk parameter angka adalah 1 hingga 7. Senin diwakili oleh 1, Selasa oleh 2, dan Minggu oleh 7.

Example

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

dayOfMth

Menghitung jumlah hari dalam bulan untuk tanggal yang ditentukan.

int dayOfMth(date date)

Parameter-parameternya

Pengaturan	Description
date	Tanggal untuk mengembalikan hari dalam bulan.

Mengembalikan nilai

Bilangan bulat antara 1 dan 31 yang menunjukkan hari dalam sebulan untuk tanggal yang ditentukan.

Komentar

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

Example

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

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

dayOfWk

Menghitung jumlah hari dalam seminggu untuk tanggal yang ditentukan.

Nota

Senin diwakili oleh 1, Selasa oleh 2, dan Minggu oleh 7.

int dayOfWk(date date)

Parameter-parameternya

Pengaturan	Description
date	Nilai tanggal yang menunjukkan tahun, bulan, dan hari.

Mengembalikan nilai

Jumlah hari yang ditentukan dalam seminggu.

Example

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

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

dayOfYr

Menghitung jumlah hari antara 1 Januari dan tanggal yang ditentukan.

int dayOfYr(date _date)

Parameter-parameternya

Pengaturan	Description
_tanggal	Tanggal yang menentukan tahun, bulan, dan hari.

Mengembalikan nilai

Jumlah hari antara 1 Januari dan tanggal yang ditentukan, inklusif.

Komentar

1 Januari adalah 1, dan 31 Desember adalah 365 atau 366 tergantung pada apakah tahun tersebut adalah tahun kampung.

Example

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

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

endMth

Menghitung tanggal terakhir dalam bulan dari tanggal yang ditentukan.

date endMth(date date)

Parameter-parameternya

Pengaturan	Description
date	Nilai tanggal yang menunjukkan tahun, bulan, dan hari.

Mengembalikan nilai

Nilai tanggal hari terakhir dalam bulan yang ditentukan.

Komentar

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

Membuat tanggal, berdasarkan tiga bilangan bulat yang menunjukkan masing-masing hari, bulan, dan tahun.

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

Parameter-parameternya

Pengaturan	Description
hari	Bilangan bulat yang mewakili hari dalam sebulan.
bulan	Bilangan bulat yang mewakili bulan dalam setahun.
tahun	Bilangan bulat yang mewakili tahun, yang harus antara 1900 dan 2154.

Mengembalikan nilai

Nilai tanggal yang didasarkan pada nilai parameter hari, bulan, dan tahun .

Komentar

Jika tanggal tidak valid, metode ini mengembalikan tanggal 0 (nol, 1/1/1900).

Example

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

mthName

Mengambil nama bulan yang ditentukan

str monthName(int number)

Parameter-parameternya

Pengaturan	Description
nomor/angka	Jumlah bulan.

Mengembalikan nilai

Nama bulan yang ditentukan.

Komentar

Nilai parameter angka yang valid adalah 1 hingga 12. Januari diwakili oleh 1 dan Desember oleh 12.

Example

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

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

mthOfYr

Mengambil jumlah bulan dalam tahun untuk tanggal yang ditentukan.

Nota

Januari adalah 1, Februari adalah 2, dan Desember adalah 12.

int mthOfYr(date date)

Parameter-parameternya

Pengaturan	Description
date	Tanggal yang menentukan tahun, bulan, dan hari.

Mengembalikan nilai

Jumlah bulan dalam tahun, untuk bulan yang diwakili oleh parameter tanggal .

Example

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

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

nextMth

Mengambil tanggal dalam bulan berikutnya yang paling sesuai dengan tanggal yang ditentukan.

date nextMth(date date)

Parameter-parameternya

Pengaturan	Description
date	Tanggal yang cocok pada bulan berikutnya.

Mengembalikan nilai

Kecocokan terdekat dengan tanggal yang ditentukan yang ditemukan pada bulan berikutnya.

Komentar

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

Example

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

Mengambil tanggal dalam kuartal berikut yang paling sesuai dengan tanggal yang ditentukan.

date nextQtr(date date)

Parameter-parameternya

Pengaturan	Description
date	Tanggal untuk mencocokkan pada kuartal berikutnya.

Mengembalikan nilai

Kecocokan terdekat dengan tanggal yang ditentukan yang ditemukan fungsi pada kuartal berikutnya.

Komentar

Misalnya, nextQtr(31\1\1998) mengembalikan 30\4\1998.

Example

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

Mengambil tanggal pada tahun berikutnya yang paling sesuai dengan tanggal yang ditentukan.

date nextYr(date date)

Parameter-parameternya

Pengaturan	Description
date	Tanggal yang akan dicocokkan pada tahun berikutnya.

Mengembalikan nilai

Kecocokan terdekat dengan tanggal yang ditentukan yang ditemukan pada tahun berikutnya.

Komentar

Misalnya, nextyr(29\2\1998) mengembalikan 28\2\1999.

Example

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

Mengambil tanggal pada bulan sebelumnya yang paling sesuai dengan tanggal yang ditentukan.

date prevMth(date date)

Parameter-parameternya

Pengaturan	Description
date	Tanggal yang akan dicocokkan pada bulan sebelumnya.

Mengembalikan nilai

Kecocokan terdekat dengan tanggal yang ditentukan yang ditemukan pada bulan sebelumnya.

Komentar

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

Mengambil tanggal di kuartal sebelumnya yang paling sesuai dengan tanggal yang ditentukan.

date prevQtr(date date)

Parameter-parameternya

Pengaturan	Description
date	Tanggal untuk mencocokkan di kuartal sebelumnya.

Mengembalikan nilai

Kecocokan terdekat dengan tanggal yang ditentukan yang ditemukan di kuartal sebelumnya.

Komentar

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

Mengambil tanggal pada tahun sebelumnya yang paling sesuai dengan tanggal yang ditentukan.

date prevYr(date date)

Parameter-parameternya

Pengaturan	Description
date	Tanggal yang akan dicocokkan pada tahun sebelumnya.

Mengembalikan nilai

Kecocokan terdekat dengan tanggal yang ditentukan yang ditemukan sistem pada tahun sebelumnya.

Komentar

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.

systemDateGet

Mengambil tanggal sesi, jika diatur.

date systemDateGet()

Mengembalikan nilai

Tanggal sesi jika diatur; jika tidak, tanggal sistem.

Komentar

Gunakan Tanggal dan waktu sesi pada menu Alat untuk membuka halaman Tanggal dan waktu sesi . Gunakan halaman ini untuk mengatur tanggal sesi. Setelah sistem mendeteksi tindakan yang ditetapkan ini, panggilan berikutnya ke fungsi systemDateGet mengembalikan tanggal sesi. Fungsi hari ini mengembalikan tanggal sistem. Fungsi ini tidak mendukung zona waktu.

Example

Contoh berikut menunjukkan tanggal di jendela 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

Mengubah tanggal sistem.

date systemDateSet(date _date)

Parameter-parameternya

Pengaturan	Description
_tanggal	Tanggal baru untuk sistem.

Mengembalikan nilai

Tanggal sistem baru.

Komentar

Fungsi ini tidak memengaruhi tanggal sesi. Metode ini mengubah tanggal, tetapi waktu diatur ke 0 (nol).

Example

Contoh berikut menetapkan tanggal sistem ke tanggal hari ini.

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

timeNow

Mengambil waktu sistem saat ini.

int timeNow()

Mengembalikan nilai

Jumlah detik yang telah berlalu sejak tengah malam.

Example

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

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

Hari Ini

Mengambil tanggal saat ini pada sistem.

date today()

Mengembalikan nilai

Tanggal saat ini.

Example

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

wkOfYr

Menghitung minggu dalam setahun tanggal jatuh, sesuai dengan spesifikasi ISO 8601.

int wkOfYr(date _date)

Parameter-parameternya

Pengaturan	Description
_tanggal	Tanggal untuk menghitung minggu dalam setahun.

Mengembalikan nilai

Jumlah urutan minggu terjadinya parameter _date .

Example

Contoh kode berikut membandingkan fungsi wkOfYr dengan metode Global::weekOfYear . Fungsi dan metode menghasilkan hasil yang berbeda.

// 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]);
    }
}

Contoh sebelumnya mengirimkan informasi berikut ke Infolog untuk ditampilkan. Output menunjukkan bahwa ada perbedaan antara wkOfYr dan 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

tahun

Mengambil tahun dari nilai tanggal .

int year(date _date)

Parameter-parameternya

Pengaturan	Description
_tanggal	Tanggal untuk mengembalikan tahun dari.

Mengembalikan nilai

Tahun dari tanggal yang ditentukan.

Komentar

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

Saran dan Komentar

Apakah halaman ini membantu?

Last updated on 2026-03-31