Hàm của kiểu dữ liệu Date trong Cogover

Kiểu dữ liệu Date trong Cogover cung cấp các hàm để tạo, chuyển đổi, truy xuất và định dạng dữ liệu Ngày (Date), áp dụng cho cả hàm của class và instance.

Loại	Cú pháp	Mô tả	Kiểu trả về	Chi tiết và ví dụ
Hàm của class	`Date.today()`	Trả về ngày hiện tại theo timezone của Workspace	Ngày (Date)	Xem thêm
Hàm của class	`Date.date(year, month, day)`	Trả về ngày khi được truyền vào các thành phần: năm, tháng, ngày	Ngày (Date)	Xem thêm
Hàm của class	`Date.fromTimestamp(timestamp)`	Chuyển đổi Timestamp (milisecond) thành đối tượng Date	Ngày (Date)	Xem thêm
Hàm của instance	`{date}.dayOfMonth()`	Trả về ngày trong tháng của một instance Ngày (Date) cụ thể	Number	Xem thêm
Hàm của instance	`{date}.dayOfYear()`	Trả về thứ tự ngày trong năm của một instance Ngày (Date) cụ thể	Number	Xem thêm
Hàm của instance	`{date}.getMonth()`	Trả về tháng của một instance Ngày (Date) cụ thể	Number	Xem thêm
Hàm của instance	`{date}.getYear()`	Trả về năm của một instance Ngày (Date) cụ thể	Number	Xem thêm
Hàm của instance	`{date}.format(format)`	Định dạng một instance Ngày (Date) theo mẫu định dạng được chỉ định	Text	Xem thêm
Hàm của instance	`{date}.addMonths(number_of_months)`	Thêm một số tháng vào một instance Ngày (Date) cụ thể	Ngày (Date)	Xem thêm

Lấy giá trị ngày hiện tại

Cú pháp: Date.today()
Mô tả: Trả về ngày hiện tại theo timezone của Workspace.
Kiểu dữ liệu trả về: Ngày (Date).

Ví dụ:

var today = Date.today();
return today;
 
// Kết quả
// today = 26/02/2025 (ngày hiện tại)

Tạo ngày từ các thành phần thời gian

Cú pháp: Date.date(year, month, day)
Mô tả: Trả về ngày khi được truyền vào các tham số: năm, tháng, ngày.
Kiểu dữ liệu trả về: Ngày (Date).

Tham số đầu vào:

Tham số	Loại dữ liệu	Bắt buộc	Mô tả
`year`	Number	Có	Năm được truyền vào
`month`	Number	Có	Tháng được truyền vào
`day`	Number	Có	Ngày được truyền vào

Ví dụ:

var date = Date.date(2025, 4, 30);
return date;
 
// Kết quả
// date = 30/04/2025

Chuyển đổi timestamp thành đối tượng Date

Cú pháp: Date.fromTimestamp(timestamp)
Mô tả: Chuyển đổi timestamp (milisecond) thành đối tượng Date. Tham khảo thêm tại đây.
Kiểu dữ liệu trả về: Ngày (Date).

Ví dụ:

var date = Date.fromTimestamp(1740540706000);
return date;
 
// Kết quả
// date = 26/02/2025

Lấy thông tin thời gian

Lấy thông tin của ngày trong tuần

Cú pháp: {date}.dayOfWeek()
Mô tả: Trả về ngày trong tuần của một instance Ngày (Date) cụ thể.
Kiểu dữ liệu trả về: Number (số 0 tới 6 tương ứng thứ 2 tới chủ nhật).

Ví dụ:

var date = Date.fromTimestamp(1740544017000);
var day = date.dayOfWeek();
return day;
 
// Kết quả
// day = 2

Lấy thông tin của ngày trong tháng

Cú pháp: {date}.dayOfMonth()
Mô tả: Trả về ngày trong tháng của một instance Ngày (Date) cụ thể.
Kiểu dữ liệu trả về: Number

Ví dụ:

var date = Date.fromTimestamp(1740544017000);
var day = date.dayOfMonth();
return day; 
 
// Kết quả
// day = 26

// $record.Ngay_sinh là trường dữ liệu dạng Ngày (Date) và có giá trị là 10/10/2000
var day = $record.Ngay_sinh.dayOfMonth();
return day;  
  
// Kết quả
// day = 10

Lấy thông tin của ngày trong năm

Cú pháp: {date}.dayOfYear()
Mô tả: Trả về ngày trong tháng của một instance Ngày (Date) cụ thể.
Kiểu dữ liệu trả về: Number

Ví dụ:

var date = Date.fromTimestamp(1740544017000);
var day = date.dayOfYear();
return day;  
 
// Kết quả
// day = 57

// $record.Ngay_sinh là trường dữ liệu dạng Ngày (Date) và có giá trị là 10/10/2000
var day = $record.Ngay_sinh.dayOfYear();
return day;
 
// Kết quả
// day = 284

Lấy thông tin tháng

Cú pháp: {date}.getMonth()
Mô tả: Trả về tháng của một instance Ngày (Date) cụ thể.
Kiểu dữ liệu trả về: Number

Ví dụ:

var date = Date.fromTimestamp(1740544017000);
var month = date.getMonth();
return month; 
 
// Kết quả
// month = 2

// $record.Ngay_sinh là trường dữ liệu dạng Ngày (Date) và có giá trị là 10/10/2000
var month = $record.Ngay_sinh.getMonth();
return month;  
 
// Kết quả
// month = 10

Lấy thông tin năm

Cú pháp: {date}.getYear()
Mô tả: Trả về năm của một instance Ngày (Date) cụ thể.
Kiểu dữ liệu trả về: Number

Ví dụ:

var date = Date.fromTimestamp(1740544017000);
var year = date.getYear();
return year;  
 
// Kết quả
// year = 2025

// $record.Ngay_sinh là trường dữ liệu dạng Ngày (Date) và có giá trị là 10/10/2000
var year = $record.Ngay_sinh.getYear();
return year;  
 
// Kết quả
// year = 2000

Định dạng thời gian

Cú pháp: {date}.format(format)
Mô tả: Định dạng một instance Ngày (Date) theo một mẫu định dạng được chỉ định.
Kiểu dữ liệu trả về: Text

Tham số đầu vào:

Tên tham số	Loại dữ liệu	Bắt buộc	Mô tả
`{date}`	Ngày (Date)	Có	Ngày cần định dạng
`format`	Text	Có	Chuỗi ký tự xác định mẫu định dạng

Ví dụ:

var date = Date.date(2017,7,27);
var result = date.format("dd MMM yyy");
return result;  
 
// Kết quả
// result = "27 Jul 2017

// $record.Ngay_sinh là trường dữ liệu dạng Ngày (Date) và có giá trị là 10/10/2000
var date = $record.Ngay_sinh.format("dd-MM-yyyy");
return date;  
 
// Kết quả
// date = "10-10-2000

Thay đổi ngày

Cú pháp: {date}.addMonths(number_of_months)
Mô tả: Thêm một số tháng vào một instance Ngày (Date) cụ thể.
Kiểu dữ liệu trả về: Ngày (Date)

Tham số đầu vào:

Tên tham số	Loại dữ liệu	Bắt buộc	Mô tả
`{date}`	Ngày (Date)	Có	Ngày cần thay đổi
`number_of_months`	Number	Có	Số tháng được thêm

Ví dụ:

var date = Date.fromTimestamp(1740544017000);
var result = date.addMonths(4);
return result;
 
// Kết quả
// result = 26/06/2025

// $record.Ngay_sinh là trường dữ liệu dạng Ngày (Date) và có giá trị là 10/10/2000
var date = $record.Ngay_sinh.addMonths(14);
return date;
 
// Kết quả
// result = 10/12/2001

Quy tắc định dạng thời gian trong Cogover

Quy tắc định dạng

Thành phần	Ký tự	Ví dụ
Ngày	`dd`	27
Tháng	`MM`	07
Tháng	`MMM`	Jul
Năm	`yyyy`	2017
Năm	`yy`	17
Ngăn cách các thành phần	`Tất cả các ký tự đặc biệt bao gồm khoảng trắng`

Định dạng thời gian thường dùng

Định dạng	Hiển thị
`dd/MM/yyyy`	27/07/2017
`dd.MM.yyyy`	27.07.2017
`yyyy-MM-dd`	2017-07-27
`dd MMM yyy`	27 Jul 2017
`ddMMMyyyy`	27Jul2017
`MMM dd, yyyy`	Jul 27, 2017
`MM/dd/yyyy`	07/27/2017
`MMM dd, yyyy`	Jul 27, 2017