Functionality

Για να χρησιμοποιήσετε τη βιβλιοθήκη Time σε ένα σκίτσο Arduino, συμπεριλάβετε το TimeLib.h.

#include <TimeLib.h>

Οι συναρτήσεις που είναι διαθέσιμες στη βιβλιοθήκη περιλαμβάνουν

Οι συναρτήσεις που είναι διαθέσιμες στη βιβλιοθήκη περιλαμβάνουν

hour();            // the hour now  (0-23)
minute();          // the minute now (0-59)
second();          // the second now (0-59)
day();             // the day now (1-31)
weekday();         // day of the week (1-7), Sunday is day 1
month();           // the month now (1-12)
year();            // the full four digit year: (2009, 2010 etc)

Υπάρχουν επίσης συναρτήσεις για την επιστροφή της ώρας σε μορφή 12 ωρών

hourFormat12();    // the hour now in 12 hour format
isAM();            // returns true if time now is AM
isPM();            // returns true if time now is PM

now();             // returns the current time as seconds since Jan 1 1970

Οι λειτουργίες ώρας και ημερομηνίας μπορούν να λάβουν μια προαιρετική παράμετρο για την ώρα. Αυτό αποτρέπει σφάλματα εάν ο χρόνος κυλήσει μεταξύ των στοιχείων. Για παράδειγμα, αν ξεκινήσει ένα νέο λεπτό μεταξύ λήψης του λεπτού και του δευτερολέπτου, οι τιμές θα είναι ασυνεπείς. Χρησιμοποιώντας το οι ακόλουθες λειτουργίες εξαλείφουν αυτό το πρόβλημα

time_t t = now(); // store the current time in time variable t
hour(t);          // returns the hour for the given time t
minute(t);        // returns the minute for the given time t
second(t);        // returns the second for the given time t
day(t);           // the day for the given time t
weekday(t);       // day of the week for the given time t
month(t);         // the month for the given time t
year(t);          // the year for the given time t

Οι λειτουργίες για τη διαχείριση των υπηρεσιών χρονοδιακόπτη είναι:

setTime(t);                      // set the system time to the give time t
setTime(hr,min,sec,day,mnth,yr); // alternative to above, yr is 2 or 4 digit yr
                                 // (2010 or 10 sets year to 2010)
adjustTime(adjustment);          // adjust system time by adding the adjustment value
timeStatus();                    // indicates if time has been set and recently synchronized
                                 // returns one of the following enumerations:
timeNotSet                       // the time has never been set, the clock started on Jan 1, 1970
timeNeedsSync                    // the time had been set but a sync attempt did not succeed
timeSet                          // the time is set and is synced

Οι τιμές ώρας και ημερομηνίας δεν είναι έγκυρες εάν η κατάσταση είναι “timeNotSet”. Διαφορετικά, μπορούν να χρησιμοποιηθούν τιμές αλλά ο χρόνος επιστροφής μπορεί να έχει μετατοπιστεί εάν η κατάσταση είναι “timeNeedsSync”.

setSyncProvider(getTimeFunction);  // set the external time provider
setSyncInterval(interval);         // set the number of seconds between re-sync

Υπάρχουν πολλές μακροεντολές ευκολίας στο αρχείο «time.h» για σταθερές χρόνου και μετατροπή των χρονικών μονάδων.

Για να χρησιμοποιήσετε τη βιβλιοθήκη, αντιγράψτε τη λήψη στον κατάλογο της Βιβλιοθήκης.