Μονάδα Λειτουργίας TIMESWITCH_ADD
Η Μονάδα Λειτουργίας TIMESWITCH_ADD δημιουργεί ή τροποποιεί ένα γεγονός σε μια χρονική ρολόι.
Σημείωση: Η χρονική ρολόι πρέπει να αποθηκεύεται στο ίδιο στοιχείο.
Συμβουλή: Για την τροποποίηση ενός γεγονότος, όλες οι τιμές μπορούν να διαβαστούν χρησιμοποιώντας τη Μονάδα Λειτουργίας TIMESWITCH_GET.
Είσοδος ADD
Η είσοδος δημιουργεί ή τροποποιεί ένα γεγονός στο ημερολόγιο, σε μια θετική ακμή. Αν η είσοδος είναι πάντα αληθής, τότε το γεγονός, όταν διαγραφεί, θα δημιουργηθεί ξανά. Οι αλλαγές ενός γεγονότος δεν αναγνωρίζονται.
Σημαντικό: Η δημιουργία και ταυτόχρονη διαγραφή πρέπει να αποφεύγεται, καθώς μπορεί να επηρεάσει σημαντικά το SSD.
Είσοδος TIMESWITCH
Εδώ αποθηκεύεται η βάση δεδομένων του χρονικού ρολογιού ως μια αλυσίδα χαρακτήρων. Αυτή πρέπει να υπάρχει ήδη ως Μονάδα Λειτουργίας TIMESWITCH. Παρατηρήστε επίσης τη σειρά του προγράμματος, ώστε αυτή η Μονάδα Λειτουργίας να αρχικοποιείται σωστά.
Είσοδος ID
Ορίζει την ταυτότητα ως αλυσίδα χαρακτήρων του γεγονότος. Αυτό επιτρέπει μια μοναδική ταυτοποίηση και αποτρέπει άλλους συμβάντες να δημιουργήσουν σύγκρουση. Η ταυτότητα πρέπει να αποτελείται μόνο από γράμματα και αριθμούς. Λαμβάνεται υπόψη η κεφαλαία και μικρή γραφή.
Σημείωση: Η ταυτότητα πρέπει να ορίζεται μοναδικά για όλα τα ημερολόγια. Ένα γεγονός μπορεί να αντιγράψει ένας χρήστης στην οπτικοποίηση σε άλλο ημερολόγιο.
Είσοδος TITLE
Ο τίτλος του γεγονότος ως αλυσίδα χαρακτήρων. Αυτός δεν πρέπει να περιέχει αλλαγές γραμμής. Αν η είσοδος ADD είναι αληθής, τότε κάθε αλλαγή γράφεται αμέσως στο ημερολόγιο.
Είσοδος DT_START
Η ώρα έναρξης του γεγονότος στο μορφή DT# επιστρέφει. Αν η είσοδος ADD είναι αληθής, τότε κάθε αλλαγή γράφεται αμέσως στο ημερολόγιο.
Συμβουλή: Οι ώρες ενεργοποίησης μπορούν να υπολογιστούν με τις Μονάδες Λειτουργίας MKTIME, STR2DT και EASTER_DATE.
Είσοδος DT_END
Η ώρα λήξης του γεγονότος στο μορφή DT# επιστρέφει. Αν η είσοδος ADD είναι αληθής, τότε κάθε αλλαγή γράφεται αμέσως στο ημερολόγιο. Αν η ώρα λήξης είναι μικρότερη από DT_START, τότε ορίζεται ως ώρα έναρξης.
Αν η είσοδος δεν ορίζεται, τότε υποθέτεται η ίδια τιμή με το DT_START και δημιουργείται ένας παλμός στο γεγονός.
Είσοδος DIS
Η είσοδος απενεργοποιεί το γεγονός στο ημερολόγιο. Αν η είσοδος ADD είναι αληθής, τότε κάθε αλλαγή γράφεται αμέσως στο ημερολόγιο.
Είσοδος REPEAT
Στην είσοδο μπορούν να οριστούν οι επαναλήψεις ως αλυσίδα χαρακτήρων. Αυτές μπορούν να γενηθούν με τις βοηθητικές συναρτήσεις REPEAT_YEARLY, REPEAT_MONTHLY, REPEAT_WEEKLY, REPEAT_DAILY και REPEAT_HOURLY ή να δηλωθούν όπως περιγράφεται.
Η αλυσίδα χαρακτήρων μπορεί να κατασκευαστεί χωρισμένη με δύο σημείων όπως παρακάτω:
w:2:4:135
Το πρώτο ψηφίο (μικρά γράμματα) ορίζει το διάστημα της επανάληψης:
| Συντόμευση | Διάστημα |
|---|---|
| h | Κάθε ώρα |
| d | Κάθημερινά |
| w | Εβδομαδιαία |
| m | Μηνιαία |
| y | Ετήσια |
Το δεύτερο ψηφίο ορίζει το διάστημα ως ακέραιος αριθμός της επανάληψης. Η μικρότερη τιμή είναι 1.
Το τρίτο ψηφίο ορίζει το τέλος της επανάληψης. Εδώ μπορούν να οριστούν τρία διαφορετικά μορφή:
- Κανένα τιμή: Η επανάληψη είναι άπειρη.
- Ως απλός ακέραιος αριθμός: Η επανάληψη τελειώνει μετά τον ορισμένο αριθμό επαναλήψεων.
- Ως ημερομηνία YYYY-MM-DD: Η επανάληψη τελειώνει πριν από την ημερομηνία.
Το τέταρτο ψηφίο ορίζει τις ημέρες της εβδομάδας στις οποίες συμβαίνει η επανάληψη. Αυτό το ψηφίο χρησιμοποιείται μόνο όταν ορίζονται εβδομαδιαίες ή μηνιαίες επαναλήψεις.
Εβδομαδιαίες Επαναλήψεις
Ελέγχεται αν η τρέχουσα ημέρα της εβδομάδας υπάρχει στον αριθμό. Πολλές ημέρες μπορούν να οριστούν απλά μια μετά την άλλη. Για παράδειγμα, 135 για Δευτέρα, Τετάρτη και Παρασκευή. Αν δεν οριστεί τιμή (0 ή μια κενή αλυσίδα χαρακτήρων), τότε δεν επαναλαμβάνεται σε καμία ημέρα.
| Αριθμός | Ημέρα της Εβδομάδας |
|---|---|
| 1 | Δευτέρα |
| 2 | Τρίτη |
| 3 | Τετάρτη |
| 4 | Πέμπτη |
| 5 | Παρασκευή |
| 6 | Σάββατο |
| 7 | Κυριακή |
Μηνιαίες Επαναλήψεις
Ορίζει σε ποια ημέρα της εβδομάδας θα επαναληφθεί το γεγονός. Υποστηρίζονται αριθμοί από -1 έως 4. 0 ή καμία δηλώση επαναλαμβάνει κάθε μήνα την ίδια ημέρα, ανεξάρτητα από την ημέρα της εβδομάδας. Η ημέρα της εβδομάδας λαμβάνεται από την πρώτη ημερομηνία.
| Τιμή | Περιγραφή |
|---|---|
| -1 | Επαναλαμβάνεται την τελευταία ημέρα της εβδομάδας. |
| 0 | Επαναλαμβάνεται την ίδια ημέρα. (Προεπιλογή) |
| 1 | Επαναλαμβάνεται την πρώτη ημέρα της εβδομάδας. |
| 2 | Επαναλαμβάνεται την δεύτερη ημέρα της εβδομάδας. |
| 3 | Επαναλαμβάνεται την τρίτη ημέρα της εβδομάδας. |
| 4 | Επαναλαμβάνεται την τέταρτη ημέρα της εβδομάδας. |
Έξοδος ERR
Σε περίπτωση σφάλματος, ο έξοδος ορίζεται σε αληθές. Αυτό μπορεί να συμβεί αν το ημερολόγιο δεν υπάρχει ή η ταυτότητα δεν έχει οριστεί ή είναι άκυρη.