Khối Chức Năng TIMESWITCH_ADD

Khối chức năng TIMESWITCH_ADD tạo hoặc sửa đổi một sự kiện trong đồ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 trữ trong cùng một phần tử.

Mẹo: Để sửa đổi một sự kiện, tất cả các giá trị có thể được đọc bằng khối chức năng TIMESWITCH_GET.

Đầu Vào ADD

Đầu vào tạo hoặc sửa đổi một sự kiện trong lịch, với một cạnh dương. Nếu đầu vào luôn là đúng, thì sự kiện sẽ được tạo lại khi nó bị xóa. Các thay đổi của sự kiện không được nhận diện.

Quan trọng: Tạo và xóa đồng thời nên tránh vì điều này có thể gây áp lực lớn cho SSD.

Đầu Vào TIMESWITCH

Đây là nơi lưu trữ cơ sở dữ liệu của đồng hồ điều khiển dưới dạng chuỗi ký tự. Nó phải được 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. Điều này cho phép xác định duy nhất và ngăn chặn các xung đột từ các sự kiện khác. ID chỉ nên bao gồm chữ cái và số. Phân biệt chữ hoa và thường được xem xét.

Lưu ý: ID nên được định nghĩa duy nhất cho tất cả các lịch. Một sự kiện có thể được người dùng sao chép vào một lịch khác trên giao diện trực quan.

Đầu Vào TITLE

Tiêu đề của sự kiện dưới dạng chuỗi ký tự. Nó không nên chứa dấu xuống dòng. Nếu đầu vào ADD là đúng, thì mọi thay đổi sẽ được ghi ngay lập tức vào lịch.

Đầu Vào DT_START

Thời điểm bắt đầu của sự kiện trong định dạng DT#. Nếu đầu vào ADD là đúng, thì mọi thay đổi sẽ được ghi ngay lập tức vào lịch.

Mẹo: Thời gian bật tắt có thể được tính toán bằng các khối chức năng MKTIME, STR2DT và EASTER_DATE.

Đầu Vào DT_END

Thời điểm kết thúc của sự kiện trong định dạng DT#. Nếu đầu vào ADD là đúng, thì mọi thay đổi sẽ được ghi ngay lập tức vào lịch. Nếu thời điểm kết thúc nhỏ hơn DT_START, thì DT_END sẽ được định nghĩa như một thời điểm bắt đầu.

Nếu đầu vào không được định nghĩa, thì giá trị giống như DT_START sẽ được giả định và một xung sẽ được tạo cho sự kiện.

Đầu Vào DIS

Đầu vào vô hiệu hóa sự kiện trong lịch. Nếu đầu vào ADD là đúng, thì mọi thay đổi sẽ được ghi ngay lập tức vào lịch.

Đầu Vào REPEAT

Các lặp lại có thể được định nghĩa dưới dạng chuỗi ký tự tại đầu vào này. Chúng có thể được tạo bằng các hàm trợ giúp REPEAT_YEARLY, REPEAT_MONTHLY, REPEAT_WEEKLY, REPEAT_DAILY và REPEAT_HOURLY hoặc được khai báo như đã mô tả.

Chuỗi ký tự có thể được xây dựng bằng cách phân tách bởi dấu hai chấm 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 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 lặp lại. Giá trị nhỏ nhất là 1.

Con số thứ ba định nghĩa kết thúc của lặp lại. Ba định dạng khác nhau có thể được định nghĩa:

• Không có giá trị: Lặp lại là vô tận.
• Dưới dạng số nguyên đơn giản: Lặp lại kết thúc sau số lần lặp đã định nghĩa.
• Dưới dạng ngày YYYY-MM-DD: Lặp lại được kết thúc trước ngày đó.

Con số thứ tư định nghĩa các ngày trong tuần mà lặp lại xảy ra. Con số này chỉ được sử dụng khi định nghĩa lặp lại hàng tuần hoặc hàng tháng.

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 như ví dụ 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ì không lặp lại 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

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 ERR

Trong trường hợp lỗi, đầu ra sẽ được đặt thành đúng. Đ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ệ.