![]() ![]() |
Η στατική κλάση DateTimeSpan παρέχει λειτουργίες για τον καθορισμό του χρόνου που μεσολαβεί μεταξύ δύο στοιχείων ημερομηνίας ή ώρας και την προσθήκη ή αφαίρεση διαστήματος χρόνου. Παρέχει ένα σύνολο συναρτήσεων για εργασία με τη διαφορά μεταξύ δύο ημερομηνιών. Εφόσον τα διαστήματα ημερομηνιών αποτελούν απλά αριθμούς, η εφαρμογή μπορεί να χρησιμοποιήσει σε αυτά απλές μαθηματικές πράξεις: πολλαπλασιασμό, διαίρεση, προσθήκη, αφαίρεση και άλλες. Αυτή η κλάση είναι στατική. Η εφαρμογή δεν μπορεί να δημιουργήσει χρήσεις της κλάσης.
Αυτή η συνάρτηση επιστρέφει μια νέα ημερομηνία η οποία αποτελεί το άθροισμα που προκύπτει από την προσθήκη δεδομένου αριθμού ετών, μηνών και ημερών στην ημερομηνία έναρξης. Οι μήνες μπορεί να είναι περισσότεροι από 12 και οι ημέρες περισσότερες από τον αριθμό ημερών ενός μήνα. Το τελικό αποτέλεσμα θα είναι το ίδιο με αυτό που θα προέκυπτε από τρεις διαφορετικές πράξεις. Προσθέστε πρώτα τα έτη. Στη συνέχεια, χρησιμοποιώντας την ημερομηνία που προκύπτει, προσθέστε τους μήνες. Στη συνέχεια, χρησιμοποιώντας την ημερομηνία που προκύπτει, προσθέστε τις ημέρες.
Κατά την προσθήκη ενός μήνα, η ημερομηνία που προκύπτει μπορεί να μην είναι έγκυρη. Για παράδειγμα, αν προσθέσετε ένα μήνα στην ημερομηνία Ιαν. 31 θα είχε ως αποτέλεσμα την μη έγκυρη ημερομηνία Φεβ. 31. Η συνάρτηση προσαρμόζει την ημερομηνία έτσι ώστε να είναι έγκυρη, σε αυτή την περίπτωση, αν το έτος δεν είναι δίσεκτο, τότε ο Φεβ. έχει 28 ημέρες και η ημερομηνία που προκύπτει θα είναι Μαρ. 3.
Οποιοδήποτε όρισμα years, months ή days μπορεί να είναι κενό ή να μην ορίζεται. Αν αυτό ισχύει, τότε η συγκεκριμένη τιμή θεωρείται ότι είναι μηδενική.
Οποιοδήποτε όρισμα years, months ή days μπορεί να είναι αρνητικό. Σε αυτή την περίπτωση, το αποτέλεσμα που προκύπτει είναι το ίδιο με αυτό που θα προέκυπτε εάν η μονάδα αφαιρούνταν από τη βασική ημερομηνία.
DateTimeSpan.addDate( startDate, years, months, days )
Μια ημερομηνία η οποία προκύπτει από την προσθήκη των ετών, των μηνών και των ημερών στην ημερομηνία έναρξης.
var startDate = date.parse( "2004-12-31" ); var endDate; endDate = DateTimeSpan( startDate, 1, 0, 0 ); // returns 2005-12-31 endDate = DateTimeSpan( startDate, 0, 1, 0 ); // returns 2005-1-31 endDate = DateTimeSpan( startDate, 0, 0, 1 ); // returns 2005-1-1 endDate = DateTimeSpan( startDate, 1, 1, 1 ); // returns 2005-3-4
Συνάρτηση DateTimeSpan.addTime
Συνάρτηση DateTimeSpan.subDate
Αυτή η συνάρτηση επιστρέφει μια νέα ημερομηνία η οποία αποτελεί το άθροισμα που προκύπτει από την προσθήκη δεδομένου αριθμού ωρών, λεπτών και δευτερολέπτων στην ημερομηνία έναρξης. Οι ώρες μπορεί να είναι περισσότερες από 24 και τα λεπτά και τα δευτερόλεπτα περισσότερα από 60. Το τελικό αποτέλεσμα θα είναι το ίδιο με αυτό που θα προέκυπτε από τρεις διαφορετικές πράξεις: προσθέστε πρώτα τις ώρες. Στη συνέχεια, χρησιμοποιώντας την ημερομηνία που προκύπτει, προσθέστε τα λεπτά. Στη συνέχεια, χρησιμοποιώντας την ημερομηνία που προκύπτει, προσθέστε τα δευτερόλεπτα.
Οποιοδήποτε από τα ορίσματα hours, minutes και seconds μπορεί να είναι κενό ή να μην ορίζεται. Αν αυτό ισχύει, τότε η συγκεκριμένη τιμή θεωρείται ότι είναι μηδενική.
Οποιοδήποτε από τα ορίσματα hours, minutes και seconds μπορεί να μην ορίζεται. Σε αυτή την περίπτωση, το αποτέλεσμα που προκύπτει είναι το ίδιο με αυτό που θα προέκυπτε εάν η μονάδα αφαιρούνταν από τη βασική ημερομηνία.
DateTimeSpan.addTime( startDate, hours, minutes, seconds )
Μια ημερομηνία η οποία προκύπτει από την προσθήκη των ωρών, των λεπτών και των δευτερολέπτων στην ημερομηνία έναρξης.
Συνάρτηση DateTimeSpan.addDate
Συνάρτηση DateTimeSpan.subTime
Επιστρέφει τον αριθμό ημερών μεταξύ δύο ημερομηνιών. Μια ημέρα ορίζεται ως αλλαγή στο ημερολόγιο. Συνεπώς, από τις 11:59:59 μμ στις 27 Φεβ. μέχρι τα μεσάνυχτα στις 28 Φεβ. είναι μία μέρα, όπως επίσης από μεσάνυχτα στις 27 Φεβ. μέχρι τις 11:59:59 στις 28 Φεβ.
DateTimeSpan.days( startDate, endDate )
Επιστρέφει τον αριθμό ημερών μεταξύ δύο ημερομηνιών.
Αυτή η συνάρτηση επιστρέφει τον αριθμό των πλήρων ωρών μεταξύ δύω ωρών. Μια πλήρης ώρα ορίζεται ως το διάστημα από ένα δεδομένο λεπτό της ώρας σε μία ώρα μέχρι το ίδιο λεπτό στην επόμενη ώρα. Για παράδειγμα, από τη 1:23:00 έως τις 2:23:00 είναι μία ώρα, ενώ από τη 1:23:00 έως τις 2:22:59 είναι μηδέν πλήρεις ώρες.
DateTimeSpan.hours( startDate, endDate )
Ο αριθμός των πλήρων ωρών μεταξύ δύο ημερομηνιών.
Αυτή η συνάρτηση επιστρέφει τον αριθμό των πλήρων λεπτών μεταξύ δύω ωρών. Ένα πλήρες λεπτό ορίζεται ως το διάστημα από ένα δεδομένο δευτερόλεπτο ενός λεπτού στο ίδιο δευτερόλεπτο στο επόμενο λεπτό. Για παράδειγμα, από τη 1:23:00 έως τη 1:24:00 είναι ένα λεπτό, ενώ από τη 1:23:00 έως τη 1:22:59 είναι μηδέν πλήρη λεπτά.
DateTimeSpan.minutes( startDate, endDate )
Ο αριθμός των πλήρων λεπτών μεταξύ δύο ημερομηνιών.
Αυτή η συνάρτηση επιστρέφει τον αριθμό των πλήρων μηνών μεταξύ δύο ημερομηνιών. Ένας πλήρης μήνας ορίζεται ως το χρονικό διάστημα από έναν αριθμό ημέρας του μήνα έως τον ίδιο αριθμό ημέρας του επόμενου μήνα. Για παράδειγμα, από τις 28 Φεβ. έως τις 28 Μαρ. είναι ένας πλήρης μήνας, ενώ από τις 28 Φεβ. έως τις 26 Μαρ. είναι μηδέν πλήρεις μήνες.
DateTimeSpan.months( startDate, endDate )
Επιστρέφει τον αριθμό πλήρων μηνών μεταξύ δύο ημερομηνιών.
Αυτή η συνάρτηση επιστρέφει τον αριθμό των δευτερολέπτων μεταξύ δύω ωρών.
DateTimeSpan.seconds( startDate, endDate )
Ο αριθμός των πλήρων λεπτών μεταξύ δύο ημερομηνιών.
Αυτή η συνάρτηση επιστρέφει μια νέα ημερομηνία η οποία αποτελεί το υπόλοιπο που προκύπτει από την αφαίρεση δεδομένου αριθμού ετών, μηνών και ημερών από την ημερομηνία έναρξης. Οι μήνες μπορεί να είναι περισσότεροι από 12 και οι ημέρες περισσότερες από τον αριθμό ημερών ενός μήνα. Το τελικό αποτέλεσμα θα είναι το ίδιο με αυτό που θα προέκυπτε από τρεις διαφορετικές πράξεις. Αφαιρέστε πρώτα τα έτη. Στη συνέχεια, χρησιμοποιώντας την ημερομηνία που προκύπτει, αφαιρέστε τους μήνες. Στη συνέχεια, χρησιμοποιώντας την ημερομηνία που προκύπτει, αφαιρέστε τις ημέρες.
Κατά την αφαίρεση ενός μήνα, η ημερομηνία που προκύπτει μπορεί να μην είναι έγκυρη. Για παράδειγμα, αν αφαιρέσετε ένα μήνα από τις 30 Μαρ. θα είχε ως αποτέλεσμα την μη έγκυρη ημερομηνία 31 Φεβ. Η συνάρτηση προσαρμόζει την ημερομηνία έτσι ώστε να είναι έγκυρη, προσαρμόζοντας την ημερομηνία στην τελευταία έγκυρη ημέρα του μήνα. Σε αυτή την περίπτωση, αν το έτος δεν είναι δίσεκτο, η ημερομηνία θα προσαρμοστεί στις 28 Φεβ.
Οποιοδήποτε όρισμα years, months ή days μπορεί να είναι κενό ή να μην ορίζεται. Σε αυτή την περίπτωση, η συγκεκριμένη τιμή θεωρείται ότι είναι μηδενική.
Οποιοδήποτε όρισμα years, months ή days μπορεί να είναι αρνητικό. Σε αυτή την περίπτωση, το αποτέλεσμα που προκύπτει είναι το ίδιο με αυτό που θα προέκυπτε εάν η μονάδα προσθετόταν στη βασική ημερομηνία.
DateTimeSpan.subDate( startDate, years, months, days )
Μια ημερομηνία η οποία προκύπτει από την αφαίρεση των ετών, των μηνών και των ημερών από την ημερομηνία έναρξης.
Συνάρτηση DateTimeSpan.addDate
Συνάρτηση DateTimeSpan.subTime
Αυτή η συνάρτηση επιστρέφει μια νέα ημερομηνία η οποία αποτελεί το αποτέλεσμα της αφαίρεσης δεδομένου αριθμού ωρών, λεπτών και δευτερολέπτων από την ημερομηνία έναρξης. Οι ώρες μπορεί να είναι περισσότερες από 24 και τα λεπτά και τα δευτερόλεπτα περισσότερα από 60. Το τελικό αποτέλεσμα θα είναι το ίδιο με αυτό που θα προέκυπτε από τρεις διαφορετικές πράξεις. Αφαιρέστε πρώτα τις ώρες. Στη συνέχεια, χρησιμοποιώντας την ημερομηνία που προκύπτει, αφαιρέστε τα λεπτά. Στη συνέχεια, χρησιμοποιώντας την ημερομηνία που προκύπτει, αφαιρέστε τα δευτερόλεπτα.
Οποιοδήποτε από τα ορίσματα hours, minutes και seconds μπορεί να είναι κενό ή να μην ορίζεται. Σε αυτή την περίπτωση, η συγκεκριμένη τιμή θεωρείται ότι είναι μηδενική.
Οποιοδήποτε από τα ορίσματα hours, minutes και seconds μπορεί να μην ορίζεται. Σε αυτή την περίπτωση, το αποτέλεσμα που προκύπτει είναι το ίδιο με αυτό που θα προέκυπτε εάν η μονάδα προσθετόταν στη βασική ημερομηνία.
DateTimeSpan.subTime( startDate, hours, minutes, seconds )
Μια ημερομηνία η οποία προκύπτει από την αφαίρεση των ωρών, των λεπτών και των δευτερολέπτων από την ημερομηνία έναρξης.
Συνάρτηση DateTimeSpan.addTime
Συνάρτηση DateTimeSpan.subDate
Αυτή η συνάρτηση υπολογίζει τον αριθμό των πλήρων ετών μεταξύ δύο ημερομηνιών. Ένα πλήρες έτος ορίζεται ότι διαρκεί από ένα δεδομένο μήνα, ημέρα, ώρα ενός έτους μέχρι τον ίδιο μήνα, ημέρα και ώρα του επόμενου έτους. Λόγω των δίσεκτων ετών, ένα πλήρες έτος μπορεί ορισμένες φορές να περιλαμβάνει 365 ημέρες και ορισμένες φορές 366 ημέρες.
Αν οποιοδήποτε όρισμα δεν αποτελεί ημερομηνία, προκύπτει εξαίρεση. Αν οποιοδήποτε όρισμα έχει τιμή "null", το αποτέλεσμα είναι επίσης "null".
DateTimeSpan.years( startDate, endDate )
Ο αριθμός των πλήρων ετών μεταξύ των δύο ημερομηνιών.
![]() ![]() |