Logo Docs

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

Cogover phát triển class DateRange và các hàm instance của kiểu dữ liệu Khoảng ngày (DateRange) cho phép người dùng xử lý và tính toán các giá trị khoảng thời gian (ngày) linh hoạt và dễ dàng.

Loại Cú pháp Mô tả Kiểu trả về Chi tiết và ví dụ
Hàm của class DateRange.of(date1, date2); Tạo một khoảng ngày với hai giá trị là ngày bắt đầu và ngày kết thúc Khoảng ngày (DateRange) Xem thêm
Hàm của instance {dateRange}.getStart() Lấy giá trị ngày bắt đầu trong một khoảng thời gian (ngày) cụ thể Ngày (Date) Xem thêm
Hàm của instance {dateRange}.getEnd() Lấy giá trị ngày kết thúc trong một khoảng thời gian (ngày) cụ thể Ngày (Date) Xem thêm
Hàm của instance {dateRange}.range() Tính toán khoảng cách của một khoảng thời gian (ngày) hoặc giữa 2 mốc thời gian Number (đơn vị: ngày) Xem thêm
Hàm của instance {dateRange}.isInRange(date) Kiểm tra một ngày cụ thể có nằm trong khoảng thời gian (ngày) hay không Boolean Xem thêm

Hàm của class DateRange

Tạo khoảng thời gian (Date)

  • Cú pháp: DateRange.of(date1, date2)
  • Mô tả: Tạo một khoảng ngày với hai giá trị là ngày bắt đầu và ngày kết thúc.
  • Kiểu dữ liệu trả về: Khoảng ngày (DateRange)
  • Tham số đầu vào:
    Tên tham số Loại dữ liệu Bắt buộc Mô tả
    date1 Ngày (Date) Có Ngày bắt đầu
    date2 Ngày (Date) Có Ngày kết thúc
  • Ví dụ: 
    var date1 = Date.date(2025, 2, 26);
var date2 = Date.date(2025, 8, 26);
var daterange = DateRange.of(date1, date2);
 
// Kết quả
// daterange = 26/02/2025 - 26/08/2025

Hàm instance của trường dữ liệu khoảng ngày (DateRange)

Lấy ngày bắt đầu trong khoảng thời gian (ngày)

  • Cú pháp: {dateRange}.getStart()
  • Mô tả: Lấy giá trị ngày bắt đầu trong một khoảng thời gian (ngày) 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ả
    {dateRange} Khoảng ngày (DateRange) Có Khoảng thời gian cần lấy giá trị ngày bắt đầu
  • Ví dụ: 
    // $record.Thoi_han_cua_hop_dong là trường dữ liệu Khoảng ngày (DateRange) và có giá trị là 26/02/2025 - 26/02/2026
var ngayBatDau = $record.Thoi_han_cua_hop_dong.getStart();
return ngayBatDau;
 
// Kết quả
// ngayBatDau = 26/02/2025

Lấy ngày kết thúc trong khoảng thời gian (ngày)

  • Cú pháp: {dateRange}.getEnd()
  • Mô tả: Lấy giá trị ngày bắt đầu trong một khoảng thời gian (ngày) 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ả
    {dateRange} Khoảng ngày (DateRange) Có Khoảng thời gian cần lấy giá trị ngày kết thúc
  • Ví dụ: 
    // $record.Thoi_han_cua_hop_dong là trường dữ liệu Khoảng ngày (DateRange) và có giá trị là 26/02/2025 - 26/02/2026
var ngayKetThuc = $record.Thoi_han_cua_hop_dong.getEnd();
return ngayKetThuc;
 
// Kết quả
// ngayKetThuc = 26/02/2026

Tính toán khoảng cách của một khoảng thời gian (ngày)

  • Cú pháp: {dateRange}.range()

  • Mô tả: Tính toán khoảng cách của một khoảng thời gian hoặc giữa 2 mốc thời gian.

  • Kiểu dữ liệu trả về: Number (đơn vị: ngày)

  • Tham số đầu vào:

    Tên tham số Loại dữ liệu Bắt buộc Mô tả
    {dateRange} Khoảng ngày (DateRange) Có Khoảng thời gian cần tính toán khoảng cách

  • Ví dụ:

    // $record.Thoi_han_cua_hop_dong là trường dữ liệu Khoảng ngày (DateRange) và có giá trị là 26/02/2025 - 26/02/2026
var range = $record.Thoi_han_cua_hop_dong.range();
return range;
 
// Kết quả
// range = 365
    var date1 = Date.date(2025, 2, 26);
var date2 = Date.date(2026, 2, 26);
var dateRange = DateRange.of(date1, date2);
var range = dateRange.range();
return range
 
// Kết quả
// range = 365
    var date1 = Date.date(2026, 2, 26);
var date2 = Date.date(2025, 2, 26);
var dateRange = DateRange.of(date1, date2);
var range = dateRange.range();
return range;
 
// Kết quả
// range = -365

Kiểm tra một ngày cụ thể có nằm trong một khoảng thời gian (ngày) hay không

  • Cú pháp: {dateRange}.isInRange(date)

  • Kiểu dữ liệu trả về: Boolean

  • Tham số đầu vào:

    Tên tham số Loại dữ liệu Bắt buộc Mô tả
    {dateRange} Khoảng ngày (DateRange) Có Khoảng thời gian được dùng để kiểm tra
    date Ngày (Date) Có Thời gian cần kiểm tra

  • Ví dụ:

    // $record.Thoi_han_cua_hop_dong là trường dữ liệu Khoảng ngày (DateRange) và có giá trị là 26/02/2025 - 26/02/2026
var date = Date.date(2025, 4, 26);
var check = $record.Thoi_han_cua_hop_dong.isInRange(date);
return check;
 
// Kết quả
// check = true
    // $record.Thoi_han_cua_hop_dong là trường dữ liệu Khoảng ngày (DateRange) và có giá trị là 26/02/2025 - 26/02/2026
var date = Date.date(2025, 4, 26);
var check = $record.Thoi_han_cua_hop_dong.isInRange(date);
return check;
 
// Kết quả
// check = false

© 2025 Cogover LLC