Khối Chức Năng TIMESWITCH_GET
Khối chức năng TIMESWITCH_GET trả về tất cả thông tin của một sự kiện của đồng hồ điều khiển thời gian.
Lưu ý: Đồng hồ điều khiển thời gian phải được lưu trong cùng một phần tử.
Đầu Vào TIMESWITCH
Đây là nơi lưu trữ cơ sở dữ liệu của đồng hồ bấm giờ dưới dạng chuỗi ký tự. Nó phải tồn tại như một khối chức năng TIMESWITCH. Hãy chú ý đến thứ tự của chương trình để đảm bảo rằng khối chức năng này được khởi tạo đúng cách.
Đầu Vào ID
Định nghĩa ID dưới dạng chuỗi ký tự của sự kiện.
Đầu Ra ERR
Trong trường hợp lỗi, đầu ra sẽ được đặt thành true. Điều này có thể xảy ra nếu lịch không tồn tại hoặc ID không được định nghĩa hoặc không hợp lệ.
Đầu Ra TITLE
Trả về tiêu đề của sự kiện.
Đầu Ra DT_START
Thời điểm bắt đầu của sự kiện trong định dạng DT# được trả về.
Đầu Ra DT_END
Thời điểm kết thúc của sự kiện trong định dạng DT# được trả về.
Đầu Ra DIS
Nếu đầu ra là true, thì sự kiện đó bị vô hiệu hóa và sẽ bị chương trình thời gian bỏ qua.
Đầu Ra REPEAT
Đầu ra trả về các lần lặp lại dưới dạng chuỗi ký tự. Chúng tương ứng với các chức năng trợ giúp REPEAT_YEARLY, REPEAT_MONTHLY, REPEAT_WEEKLY, REPEAT_DAILY và REPEAT_HOURLY.
Chuỗi ký tự có thể được phân tách bởi dấu hai chấm hoặc được xây dựng như sau:
w:2:4:135
Con số đầu tiên (viết thường) định nghĩa khoảng thời gian của việc lặp lại:
| Tên viết tắt | Khoảng thời gian |
|---|---|
| h | Hàng giờ |
| d | Hằng ngày |
| w | Hàng tuần |
| m | Hằng tháng |
| y | Hàng năm |
Con số thứ hai định nghĩa khoảng cách dưới dạng số nguyên của việc lặp lại. Giá trị nhỏ nhất là 1.
Con số thứ ba định nghĩa kết thúc của việc lặp lại. Đây có thể được định nghĩa theo ba định dạng khác nhau:
- Không có giá trị: Việc lặp lại là vô tận.
- Dưới dạng số nguyên đơn giản: Việc lặp lại kết thúc sau số lần lặp lại đã định nghĩa.
- Dưới dạng ngày YYYY-MM-DD: Việc lặp lại sẽ kết thúc trước ngày đó.
Con số thứ tư định nghĩa các ngày trong tuần mà việc lặp lại xảy ra. Con số này chỉ được sử dụng khi định nghĩa việc lặp lại hàng tuần hoặc hàng tháng.
Việc Lặp Lại Hàng Tuần
Được kiểm tra xem ngày trong tuần hiện tại có tồn tại trong số hay không. Nhiều ngày có thể được liệt kê liên tiếp. Ví dụ như 135 cho thứ Hai, thứ Tư và thứ Sáu. Nếu không có giá trị được chỉ định (0 hoặc một chuỗi ký tự rỗng), thì việc lặp lại sẽ không xảy ra vào bất kỳ ngày nào.
| Số | Ngày trong tuần |
|---|---|
| 1 | Thứ Hai |
| 2 | Thứ Ba |
| 3 | Thứ Tư |
| 4 | Thứ Năm |
| 5 | Thứ Sáu |
| 6 | Thứ Bảy |
| 7 | Chủ Nhật |
Việc Lặp Lại Hàng Tháng
Định nghĩa ngày trong tuần mà sự kiện sẽ được lặp lại. Các số từ -1 đến 4 được hỗ trợ. 0 hoặc không khai báo sẽ lặp lại hàng tháng vào cùng ngày, bất kể ngày trong tuần. Ngày trong tuần được lấy từ ngày đầu tiên.
| Giá Trị | Mô Tả |
|---|---|
| -1 | Lặp lại vào ngày cuối cùng trong tuần. |
| 0 | Lặp lại vào cùng ngày. (Mặc định) |
| 1 | Lặp lại vào ngày đầu tiên trong tuần. |
| 2 | Lặp lại vào ngày thứ hai trong tuần. |
| 3 | Lặp lại vào ngày thứ ba trong tuần. |
| 4 |
Lặp lại vào ngày thứ tư trong tuần. |
Đầu Ra DT_MODIFY
Đầu ra định nghĩa lần thay đổi cuối cùng trong định dạng DT#. Đầu vào này cũng có thể không được định nghĩa nếu sự kiện được tạo trước phiên bản 5.0.