Date.parse()

Try it

// Standard date-time string format
const unixTimeZero = Date.parse("1970-01-01T00:00:00Z");
// Non-standard format resembling toUTCString()
const javaScriptRelease = Date.parse("04 Dec 1995 00:12:00 GMT");

console.log(unixTimeZero);
// Expected output: 0

console.log(javaScriptRelease);
// Expected output: 818035920000

Cú pháp

Date.parse(dateString)

Tham số

dateString

Một chuỗi theo định dạng chuỗi ngày giờ. Xem tài liệu tham khảo được liên kết để biết các lưu ý khi sử dụng các định dạng khác nhau.

Giá trị trả về

Một số đại diện cho timestamp của ngày đã cho. Nếu dateString không thể được phân tích như một ngày hợp lệ, NaN sẽ được trả về.

Mô tả

Hàm này hữu ích để thiết lập giá trị ngày dựa trên các giá trị chuỗi, ví dụ kết hợp với phương thức setTime().

Các định dạng mà parse() có thể xử lý không được quy định rõ ràng, nhưng có một vài bất biến:

• Định dạng chuỗi ngày giờ (được tạo bởi toISOString()) phải được hỗ trợ.
• Nếu x là bất kỳ Date nào có lượng mili giây bằng không, thì x.valueOf() phải bằng bất kỳ giá trị nào trong số sau: Date.parse(x.toString()), Date.parse(x.toUTCString()), Date.parse(x.toISOString()). Điều này có nghĩa là các định dạng được tạo bởi toString() và toUTCString() cũng phải được hỗ trợ.
• Đặc tả không yêu cầu hỗ trợ định dạng được tạo bởi toLocaleString(). Tuy nhiên, các engine chính đều cố gắng hỗ trợ định dạng toLocaleString("en-US").

Các định dạng khác được xác định bởi triển khai và có thể không hoạt động trên tất cả các trình duyệt. Một thư viện có thể giúp ích nếu cần hỗ trợ nhiều định dạng khác nhau. Trên thực tế, sự không đáng tin cậy của Date.parse() là một trong những động lực để giới thiệu API Temporal.

Vì parse() là một phương thức tĩnh của Date, bạn luôn sử dụng nó như Date.parse(), chứ không phải như phương thức của một đối tượng Date mà bạn đã tạo.

Ví dụ

Sử dụng Date.parse()

Tất cả các lệnh gọi sau đây trả về 1546300800000. Lệnh gọi đầu tiên sẽ ngầm định là giờ UTC vì nó chỉ có ngày, và các lệnh khác chỉ định rõ múi giờ UTC.

Date.parse("2019-01-01");
Date.parse("2019-01-01T00:00:00.000Z");
Date.parse("2019-01-01T00:00:00.000+00:00");

Lệnh gọi sau không chỉ định múi giờ sẽ được đặt thành 2019-01-01 lúc 00:00:00 theo múi giờ địa phương của hệ thống, vì nó có cả ngày và giờ.

Date.parse("2019-01-01T00:00:00");

Định dạng toString() và toUTCString()

Ngoài định dạng chuỗi ngày giờ chuẩn, các định dạng toString() và toUTCString() cũng được hỗ trợ:

// định dạng toString()
Date.parse("Thu Jan 01 1970 00:00:00 GMT-0500 (Eastern Standard Time)");
// 18000000 trong tất cả các triển khai ở tất cả các múi giờ

// định dạng toUTCString()
Date.parse("Thu, 01 Jan 1970 00:00:00 GMT");
// 0 trong tất cả các triển khai ở tất cả các múi giờ

Chuỗi ngày không chuẩn

Các triển khai thường mặc định theo múi giờ địa phương khi chuỗi ngày không chuẩn. Để nhất quán, chúng ta sẽ giả định rằng runtime sử dụng múi giờ UTC, và trừ khi được chỉ định khác, đầu ra sẽ thay đổi theo múi giờ của thiết bị. Giờ tiết kiệm ánh sáng ban ngày (DST), của múi giờ địa phương, cũng có thể ảnh hưởng đến điều này.

Dưới đây là một số ví dụ khác về chuỗi ngày không chuẩn. Các trình duyệt rất khoan nhượng khi phân tích chuỗi ngày và có thể bỏ qua bất kỳ phần nào của chuỗi mà chúng không thể phân tích. Vì lý do tương thích, các trình duyệt thường sao chép hành vi của nhau, vì vậy các mẫu xử lý này có xu hướng lan truyền giữa các trình duyệt. Như đã nói ở trên, các ví dụ sau chỉ để minh họa và không toàn diện:

Thông số kỹ thuật

Khả năng tương thích với trình duyệt

Xem thêm

• Date.UTC()