Bài viết này giải thích cách định dạng ngày và giờ khi gửi dữ liệu sản phẩm. Bạn gửi ngày và giờ cho các thuộc tính như ngày có hàng [availability_date], ngày giá ưu đãi có hiệu lực [sale_price_effective_date] và ngày hết hạn [expiration_date].
Trên trang này
Cách hoạt động
Bạn có thể sử dụng tiêu chuẩn ISO 8601 được giải thích chi tiết hơn trong bài viết này. Tùy theo thuộc tính, bạn sẽ gửi ngày hoặc phạm vi ngày đồng thời có thể thêm giờ cụ thể.
Định dạng một ngày
Thêm ngày ở định dạng sau:
YYYY-MM-DD
Ví dụ: để gửi ngày 11 tháng 5 năm 2017, hãy sử dụng:
2017-05-11
Thêm giờ
Cách thêm giờ cụ thể vào ngày của bạn:
- Hãy tìm ngày có chữ
T - Thêm giờ trong ngày theo định dạng 24 giờ:
hh:mm:ss. Ví dụ:13:00:14 - Sau giờ, hãy thêm múi giờ. Ví dụ: đối với UTC-8, hãy sử dụng:
-0800
Ví dụ: để gửi Ngày 11 tháng 5 năm 2017 lúc 12:01:59 SA cho múi giờ UTC-8, hãy sử dụng:
2017-05-11T00:01:59-0800
Nếu bạn không thêm giờ, chúng tôi sẽ sử dụng giờ cuối ngày: 23:59:59
Nếu bạn không thêm múi giờ, chúng tôi sẽ sử dụng múi giờ mặc định:
- Nguồn cấp dữ liệu văn bản và XML sẽ sử dụng múi giờ mặc định cho quốc gia mục tiêu của bạn.
- API sẽ sử dụng UTC.
| Quốc gia | Múi giờ mặc định cho nguồn cấp dữ liệu văn bản và XML |
|---|---|
| Úc | +1000 |
| Brazil | -0300 |
| Canada | -0500 |
| Các quốc gia Trung Âu | +0100 |
| Nhật Bản | +0900 |
| Mexico | -0600 |
| New Zealand | +1200 |
| Nga | +0400 |
| Singapore | +0800 |
| Vương quốc Anh | Z hoặc +00:00 |
| Hoa Kỳ | -0800 |
Định dạng phạm vi ngày
Một số thuộc tính chấp nhận phạm vi ngày có ngày bắt đầu và ngày kết thúc. Phạm vi ngày là ngày bắt đầu và ngày kết thúc được phân tách bằng dấu gạch chéo ( / ): bắt đầu/kết thúc
Ví dụ:
2017-05-11T00:01:59-0800/2017-06-21T22:13:59-0800cho giờ PST2017-02-24T11:07:31+0100cho Giờ Trung Âu
Nếu bạn không thêm giờ, ngày bắt đầu sẽ sử dụng 00:00:00 và ngày kết thúc sẽ sử dụng 23:59:59.
Ví dụ
Biến thể
| Dữ liệu sản phẩm áo thun Android – Xanh lá cây – Cỡ nhỏ | |
| Thuộc tính | Dữ liệu sản phẩm |
Tiêu đề [title] |
Áo thun Android – Xanh lục – Cỡ nhỏ |
Giá [price] |
109900 VND |
Giá ưu đãi [sale_price] |
99900.00 VND |
Ngày giá ưu đãi có hiệu lực [sale_price_effective_date] |
2016-02-24T13:00-0800/2016-02-29T15:30-0800 |
Màu sắc [color] |
xanh lục |
Kích thước [size] |
s |
Mã nhận dạng [id] |
9876-S-GRN |
Mã nhóm mặt hàng [item_group_id] |
9876 |
| Dữ liệu sản phẩm áo thun Android – Xanh dương – Cỡ nhỏ | |
| Thuộc tính | Dữ liệu sản phẩm |
Tiêu đề [title] |
Áo thun Android – Xanh dương – Cỡ nhỏ |
Giá [price] |
89900 VND |
Giá ưu đãi [sale_price] |
59900.00 VND |
Ngày giá ưu đãi có hiệu lực [sale_price_effective_date] |
2016-06-23T13:00-0800/2016-02-29T15:30-0800 |
Màu sắc [color] |
xanh dương |
Kích thước [size] |
s |
Mã nhận dạng [id] |
9876-S-BLU |
Mã nhóm mặt hàng [item_group_id] |
9876 |
| Dữ liệu sản phẩm áo thun Android – Đỏ – Cỡ nhỏ | |
| Thuộc tính | Dữ liệu sản phẩm |
Tiêu đề [title] |
Áo thun Android – Đỏ – Cỡ nhỏ |
Giá [price] |
105000 VND |
Giá ưu đãi [sale_price] |
89900 VND |
Ngày giá ưu đãi có hiệu lực [sale_price_effective_date] |
2016-05-11T13:00-0800/2016-02-29T15:30-0800 |
Màu sắc [color] |
đỏ |
Kích thước [size] |
s |
Mã nhận dạng [id] |
9876-S-RED |
Mã nhóm mặt hàng [item_group_id] |
9876 |
Sản phẩm có sẵn để đặt hàng trước với ngày phát hành cụ thể
| Dữ liệu sản phẩm dành cho thú bông Android Squishable | |
| Thuộc tính | Dữ liệu sản phẩm |
Tình trạng còn hàng [availability] |
preorder |
Ngày có hàng [availability_date] |
2016-12-25T13:00-0800 |
Ngày hết hạn
| Dữ liệu sản phẩm của Lederhosen | |
| Thuộc tính | Dữ liệu sản phẩm |
Tiêu đề [title] |
Lederhosen – nâu – L |
Ngày hết hạn [expiration_date] |
2016-12-25 |