Chỉ mục
DateTime
Biểu thị giờ dân sự (hoặc đôi khi là giờ thực tế).
Loại này có thể biểu thị thời gian dân sự theo một trong vài cách sau:
- Khi bạn đặt utc_offset và không đặt múi giờ: giờ dân sự trong một ngày theo lịch có thời gian chênh lệch cụ thể so với giờ UTC.
- Khi bạn đặt múi giờ và không đặt utc_offset: giờ dân sự vào một ngày theo lịch thuộc một múi giờ cụ thể.
- Khi không đặt múi giờ và utc_offset: giờ dân sự trong một ngày theo lịch theo giờ địa phương.
Ngày này có liên quan đến Lịch Gregorian Proleptic.
Nếu năm, tháng hoặc ngày bằng 0, thì DateTime được coi là không có năm, tháng hoặc ngày cụ thể tương ứng.
Loại này cũng có thể dùng để biểu thị thời gian thực nếu bạn đặt tất cả các trường ngày và giờ, đồng thời đặt một trong hai trường hợp của một trong số time_offset. Thay vào đó, hãy cân nhắc sử dụng tin nhắn Timestamp cho thời gian thực. Nếu trường hợp sử dụng của bạn cũng muốn lưu trữ múi giờ của người dùng, thì bạn có thể thực hiện việc đó trong một trường khác.
Loại này linh hoạt hơn so với mong muốn của một số ứng dụng. Đừng quên ghi lại và xác thực các giới hạn của ứng dụng.
| Trường | |
|---|---|
year |
Không bắt buộc. Năm của ngày. Giá trị phải từ 1 đến 9999 hoặc bằng 0 nếu chỉ định ngày giờ không có năm. |
month |
Không bắt buộc. Tháng trong năm. Giá trị phải từ 1 đến 12 hoặc bằng 0 nếu chỉ định ngày giờ mà không có tháng. |
day |
Không bắt buộc. Ngày trong tháng. Giá trị phải từ 1 đến 31 và hợp lệ trong năm và tháng hoặc bằng 0 nếu chỉ định ngày giờ không có ngày. |
hours |
Không bắt buộc. Giờ trong ngày ở định dạng 24 giờ. Nên từ 0 đến 23, mặc định là 0 (nửa đêm). API có thể chọn cho phép giá trị "24:00:00" cho các tình huống như thời gian đóng cửa doanh nghiệp. |
minutes |
Không bắt buộc. Số phút trong ngày. Giá trị phải nằm trong khoảng từ 0 đến 59, giá trị mặc định là 0. |
seconds |
Không bắt buộc. Số giây của thời gian. Giá trị mặc định thường là từ 0 đến 59, giá trị mặc định là 0. Một API có thể cho phép giá trị 60 nếu cho phép bật-giây. |
nanos |
Không bắt buộc. Phân số giây tính bằng nano giây. Giá trị mặc định là từ 0 đến 999.999.999, giá trị mặc định là 0. |
Trường kết hợp time_offset. Không bắt buộc. Chỉ định độ lệch UTC hoặc múi giờ của DateTime. Hãy chọn cẩn thận các lựa chọn, vì dữ liệu múi giờ có thể thay đổi trong tương lai (ví dụ: một quốc gia sửa đổi ngày bắt đầu/kết thúc DST và ngày giờ trong tương lai trong phạm vi bị ảnh hưởng đã được lưu trữ). Nếu bạn bỏ qua thuộc tính này, DateTime sẽ được coi là theo giờ địa phương. time_offset chỉ có thể là một trong những trạng thái sau đây: |
|
utc_offset |
Độ lệch UTC. Phải là số giây, từ -18 giờ đến +18 giờ. Ví dụ: chênh lệch UTC là -4:00 sẽ được biểu thị là { seconds: -14400 }. |
time_zone |
Múi giờ. |
LatLng
Đối tượng đại diện cho cặp vĩ độ/kinh độ. Giá trị này được biểu thị bằng cặp số đại diện cho vĩ độ và độ kinh độ. Trừ phi có quy định khác, đối tượng này phải tuân thủ tiêu chuẩn WGS84. Giá trị phải nằm trong phạm vi chuẩn hoá.
| Trường | |
|---|---|
latitude |
Vĩ độ tính bằng độ. Giá trị này phải nằm trong khoảng [-90.0, +90.0]. |
longitude |
Kinh độ tính bằng độ. Giá trị này phải nằm trong khoảng [-180.0, +180.0]. |
TimeZone
Biểu thị một múi giờ từ Cơ sở dữ liệu múi giờ IANA.
| Trường | |
|---|---|
id |
Múi giờ của cơ sở dữ liệu múi giờ IANA, ví dụ: "America/New_New". |
version |
Không bắt buộc. Số phiên bản của Cơ sở dữ liệu múi giờ IANA, ví dụ: "2019a". |