Προηγούμενο Επόμενο

Κλάση BirtDuration

Η κλάση BirtDuration παρέχει συναρτήσεις για την ανάκτηση τμημάτων χρονικών περιόδων ή διαρκειών, οι οποίες χρησιμοποιούνται σε έγγραφα XML. Οι διάρκειες καθορίζονται με την εξής μορφή:

PnYnMnDTnHnMnS

όπου:

*
*
Το nY υποδεικνύει το πλήθος των ετών
*
Το nM υποδεικνύει το πλήθος των μηνών
*
Το nD υποδεικνύει το πλήθος των ημερών
*
*
Το nH υποδεικνύει το πλήθος των ωρών
*
Το nM υποδεικνύει το πλήθος των λεπτών
*
Το nS υποδεικνύει το πλήθος των δευτερολέπτων

Για παράδειγμα, η παρακάτω τιμή υποδεικνύει μια διάρκεια 2 ετών, 3 μηνών και 5 ημερών:

P2Y3M5D

Η ακόλουθη τιμή υποδεικνύει μια διάρκεια 10 ωρών:

PT10H

Η κλάση BirtDuration είναι στατική. Η εφαρμογή δεν μπορεί να δημιουργήσει χρήσεις της κλάσης.

BirtDuration.add

Αυτή η συνάρτηση προσθέτει δύο διάρκειες και επιστρέφει το άθροισμα

Σύνταξη

string BirtDuration.add(string lexicalDuration1, string lexicalDuration2)

Παράμετροι

lexicalDuration1

Σειρά χαρακτήρων. Η πρώτη διάρκεια που θα προστεθεί.

lexicalDuration2

Σειρά χαρακτήρων. Η δεύτερη διάρκεια που θα προστεθεί.

Επιστρέφει

Σειρά χαρακτήρων. Το άθροισμα των δύο διαρκειών εισόδου.

Παραδείγματα

Το ακόλουθο παράδειγμα προσθέτει δύο τιμές διάρκειας:

BirtDuration.add("P1Y3M", "P13M") // επιστρέφει την τιμή P2Y4M

BirtDuration.addTo

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

Σύνταξη

Date BirtDuration.add(string lexicalDuration, Date date)

Παράμετροι

lexicalDuration

Σειρά χαρακτήρων. Η διάρκεια που θα προστεθεί.

date

Αντικείμενο ημερομηνίας. Η ημερομηνία και ώρα προς τροποποίηση.

Επιστρέφει

Αντικείμενο ημερομηνίας. Η ημερομηνία συν τη διάρκεια.

Παραδείγματα

Το ακόλουθο παράδειγμα προσθέτει ένα χρόνο στην σημερινή ημερομηνία και ώρα:

var today = new Date();
var annualDate = BirtDuration.addTo(today, "P1Y")

BirtDuration.compare

Αυτή η συνάρτηση ελέγχει αν μια διάρκεια είναι ίδια, μικρότερη ή μεγαλύτερη από μια άλλη διάρκεια.

Σύνταξη

integer BirtDuration.compare(string lexicalDuration1, string lexicalDuration2)

Παράμετροι

lexicalDuration1

Σειρά χαρακτήρων. Η πρώτη διάρκεια που θα χρησιμοποιηθεί στη σύγκριση.

lexicalDuration2

Σειρά χαρακτήρων. Η δεύτερη διάρκεια που θα χρησιμοποιηθεί στη σύγκριση.

Επιστρέφει

Ακέραιος. Σχέση μερικής σειράς μεταξύ δύο διαρκειών. Επιστρέφει την τιμή 1 αν η πρώτη διάρκεια είναι μεγαλύτερη, 0 αν είναι ίσες και -1 αν η δεύτερη διάρκεια είναι μεγαλύτερη.

Παραδείγματα

Οι ακόλουθες εκφράσεις συγκρίνουν συγκεκριμένες διάρκειες:

BirtDuration.compare("P1Y", "P12M"); // επιστρέφει την τιμή 0
BirtDuration.compare( "P3M" , "P100D" ) // επιστρέφει την τιμή -1
BirtDuration.compare( "PT25H" , "P1D" ) // επιστρέφει την τιμή 1

BirtDuration.day

Αυτή η συνάρτηση επιστρέφει την τιμή ημερών μιας συγκεκριμένης διάρκειας.

Σύνταξη

integer BirtDuration.day( string lexicalDuration)

Παράμετρος

lexicalDuration

Σειρά χαρακτήρων. Μια διάρκεια από την οποία θα ανακτηθεί η τιμή των ημερών.

Επιστρέφει

Έναν ακέραιο που αναπαριστά την τιμή ημερών της καθορισμένης διάρκειας.

Παραδείγματα

Τα ακόλουθα παραδείγματα επιδεικνύουν τις τιμές ημερών που επιστρέφονται για συγκεκριμένες διάρκειες:

BirtDuration.day( "P1Y15DT12H" ) // επιστρέφει την τιμή 15
BirtDuration.day( "P5Y2M" ) // επιστρέφει την τιμή 0

BirtDuration.getSign

Αυτή η συνάρτηση επιστρέφει το πρόσημο μιας διάρκειας.

Σύνταξη

integer BirtDuration.getSign(string lexicalDuration)

Παράμετροι

lexicalDuration

Σειρά χαρακτήρων. Η διάρκεια που θα αναλυθεί.

Επιστρέφει

Ακέραιος. Το πρόσημο της διάρκειας ως πολλαπλασιαστής. Επιστρέφει την τιμή 1 για μια θετική διάρκεια, -1 για μια αρνητική διάρκεια και 0 για τιμή null ή 0.

Παραδείγματα

Η ακόλουθη έκφραση αναλύει τα πρόσημα μιας συγκεκριμένης διάρκειας:

BirtDuration.getSign("P0Y"); // επιστρέφει την τιμή 0
BirtDuration.getSign("-P8Y2M3D"); // επιστρέφει την τιμή -1

BirtDuration.hour

Αυτή η συνάρτηση επιστρέφει την τιμή ωρών μιας συγκεκριμένης διάρκειας.

Σύνταξη

integer BirtDuration.hour( string lexicalDuration)

Παράμετρος

lexicalDuration

Σειρά χαρακτήρων. Μια διάρκεια από την οποία θα ανακτηθεί η τιμή των ωρών.

Επιστρέφει

Ένας ακέραιος που αναπαριστά την τιμή ωρών της καθορισμένης διάρκειας.

Παραδείγματα

Τα ακόλουθα παραδείγματα επιδεικνύουν τις τιμές ωρών που επιστρέφονται για συγκεκριμένες διάρκειες:

BirtDuration.hour( "P1Y15DT12H" ) // επιστρέφει την τιμή 12
BirtDuration.hour( "P5Y2M" ) // επιστρέφει την τιμή 0

BirtDuration.isLongerThan

Αυτή η συνάρτηση ελέγχει αν μία διάρκεια είναι μεγαλύτερη από μια άλλη διάρκεια. Ορισμένες φορές, η σχέση μεταξύ διαρκειών δεν μπορεί να καθοριστεί, για παράδειγμα, ένας μήνας (P1M) και 30 ημέρες (P30D), ή ένα έτος (P1Y) και 365 ημέρες (P365D). Σε αυτές τις περιπτώσεις, η συνάρτηση επιστρέφει την τιμή false.

Σύνταξη

boolean BirtDuration.isLongerThan( string lexicalDuration1, string lexicalDuration2 )

Παράμετροι

lexicalDuration1

Σειρά χαρακτήρων. Η πρώτη διάρκεια που θα χρησιμοποιηθεί στη σύγκριση.

lexicalDuration2

Σειρά χαρακτήρων. Η δεύτερη διάρκεια που θα χρησιμοποιηθεί στη σύγκριση.

Επιστρέφει

Λογική τιμή. True αν η πρώτη διάρκεια είναι μεγαλύτερη από τη δεύτερη, σε διαφορετική περίπτωση επιστρέφει την τιμή false.

Παραδείγματα

Οι ακόλουθες εκφράσεις συγκρίνουν συγκεκριμένες διάρκειες:

BirtDuration.isLongerThan( "P1Y3M" , "P13M" ) // επιστρέφει την τιμή true
BirtDuration.isLongerThan( "P2M" , "P62D" ) // επιστρέφει την τιμή false
BirtDuration.isLongerThan( "PT25H" , "P1D" ) // επιστρέφει την τιμή true

BirtDuration.isShorterThan

Αυτή η συνάρτηση ελέγχει αν μία διάρκεια είναι μικρότερη από μια άλλη διάρκεια. Ορισμένες φορές, η σχέση μεταξύ διαρκειών δεν μπορεί να καθοριστεί, για παράδειγμα, ένας μήνας (P1M) και 30 ημέρες (P30D), ή ένα έτος (P1Y) και 365 ημέρες (P365D). Σε αυτές τις περιπτώσεις, η συνάρτηση επιστρέφει την τιμή false.

Σύνταξη

boolean BirtDuration.isShorterThan( string lexicalDuration1, string lexicalDuration2 )

Παράμετροι

lexicalDuration1

Σειρά χαρακτήρων. Η πρώτη διάρκεια που θα χρησιμοποιηθεί στη σύγκριση.

lexicalDuration2

Σειρά χαρακτήρων. Η δεύτερη διάρκεια που θα χρησιμοποιηθεί στη σύγκριση.

Επιστρέφει

Λογική τιμή. True αν η πρώτη διάρκεια είναι μικρότερη από τη δεύτερη, σε διαφορετική περίπτωση επιστρέφει την τιμή false.

Παραδείγματα

Οι ακόλουθες εκφράσεις συγκρίνουν συγκεκριμένες διάρκειες:

BirtDuration.isShorterThan( "P1Y3M" , "P13M" ) // επιστρέφει την τιμή false
BirtDuration.isShorterThan( "P2M" , "P62D" ) // επιστρέφει την τιμή false
BirtDuration.isShorterThan( "PT25H" , "P1D" ) // επιστρέφει την τιμή false
BirtDuration.isShorterThan( "P27D" , "P1M" ) // επιστρέφει την τιμή true

BirtDuration.minute

Αυτή η συνάρτηση επιστρέφει την τιμή λεπτών μιας συγκεκριμένης διάρκειας.

Σύνταξη

integer BirtDuration.minute(string lexicalDuration)

Παράμετρος

lexicalDuration

Σειρά χαρακτήρων. Μια διάρκεια από την οποία θα ανακτηθεί η τιμή των λεπτών.

Επιστρέφει

Ακέραιος. Ένας αριθμός που αναπαριστά την τιμή λεπτών της καθορισμένης διάρκειας.

Παραδείγματα

Τα ακόλουθα παραδείγματα επιδεικνύουν τις τιμές λεπτών που επιστρέφονται για συγκεκριμένες διάρκειες:

BirtDuration.minute( "P1Y15DT12H30M45S" ) // επιστρέφει την τιμή 30
BirtDuration.minute( "P5Y2M8DT15H" ) // επιστρέφει την τιμή 0

BirtDuration.month

Αυτή η συνάρτηση επιστρέφει την τιμή μηνών μιας συγκεκριμένης διάρκειας.

Σύνταξη

integer BirtDuration.month(string lexicalDuration)

Παράμετρος

lexicalDuration

Σειρά χαρακτήρων. Μια διάρκεια από την οποία θα ανακτηθεί η τιμή των μηνών.

Επιστρέφει

Ακέραιος. Ένας αριθμός που αναπαριστά την τιμή μηνών της καθορισμένης διάρκειας.

Παραδείγματα

Τα ακόλουθα παραδείγματα επιδεικνύουν τις τιμές μηνών που επιστρέφονται για συγκεκριμένες διάρκειες:

BirtDuration.month( "P1Y3M15DT12H30M45S" ) // επιστρέφει την τιμή 3
BirtDuration.month( "P5Y8DT15H" ) // επιστρέφει την τιμή 0

BirtDuration.multiply

Αυτή η συνάρτηση επιστρέφει το γινόμενο μιας διάρκειας και ενός κανονικού αριθμού.

Σύνταξη

string BirtDuration.multiply(string lexicalDuration, integer factor)

Παράμετρος

lexicalDuration

Σειρά χαρακτήρων. Μια διάρκεια για πολλαπλασιασμό.

factor

Ακέραιος. Ένας κανονικός αριθμός για πολλαπλασιασμό.

Επιστρέφει

Σειρά χαρακτήρων. Το γινόμενο της διάρκειας εισόδου και του συντελεστή.

Παραδείγματα

Τα ακόλουθα παραδείγματα εμφανίζουν τα γινόμενα που επιστρέφονται για μια συγκεκριμένες διάρκειες και συντελεστές:

BirtDuration.multiply( "P1Y3M15DT12H30M45S", 1)
// επιστρέφει την τιμή P1Y3M15DT12H30M45S
BirtDuration.multiply( "P5Y8DT15H", 0) // επιστρέφει την τιμή P0Y0DT0H

BirtDuration.negate

Αυτή η συνάρτηση επιστρέφει την αρνητική τιμή μιας διάρκειας.

Σύνταξη

string BirtDuration.negate(string lexicalDuration)

Παράμετρος

lexicalDuration

Σειρά χαρακτήρων. Διάρκεια που θα μετατραπεί σε αρνητική.

Επιστρέφει

Σειρά χαρακτήρων. Η αρνητική τιμή της διάρκειας εισόδου.

Παραδείγματα

Τα ακόλουθα παραδείγματα επιδεικνύουν το αρνητικό αποτέλεσμα μιας συγκεκριμένης διάρκειας:

BirtDuration.negate( "P1Y3M15DT12H30M45S")
// επιστρέφει την τιμή -P1Y3M15DT12H30M45S

BirtDuration.second

Αυτή η συνάρτηση επιστρέφει την τιμή δευτερολέπτων μιας συγκεκριμένης διάρκειας.

Σύνταξη

integer BirtDuration.second(string lexicalDuration)

Παράμετρος

lexicalDuration

Σειρά χαρακτήρων. Μια διάρκεια από την οποία θα ανακτηθεί η τιμή των δευτερολέπτων.

Επιστρέφει

Ακέραιος. Ένας αριθμός που αναπαριστά την τιμή δευτερολέπτων της καθορισμένης διάρκειας.

Παραδείγματα

Τα ακόλουθα παραδείγματα επιδεικνύουν τις τιμές δευτερολέπτων που επιστρέφονται για συγκεκριμένες διάρκειες:

BirtDuration.second( "P1Y3M15DT12H30M45S" ) // επιστρέφει την τιμή 5
BirtDuration.second( "P5Y8DT15H" ) // επιστρέφει την τιμή 0

BirtDuration.subtract

Αυτή η συνάρτηση αφαιρεί μια διάρκεια από μια άλλη διάρκεια.

Σύνταξη

string BirtDuration.subtract(string lexicalDuration1, string lexicalDuration2)

Παράμετροι

lexicalDuration1

Σειρά χαρακτήρων. Η διάρκεια από την οποία θα πραγματοποιηθεί η αφαίρεση.

lexicalDuration2

Σειρά χαρακτήρων. Η διάρκεια που θα αφαιρεθεί από την τιμή lexicalDuration1.

Επιστρέφει

Σειρά χαρακτήρων. Η διαφορά μεταξύ των δύο διαρκειών εισόδου.

Παραδείγματα

Το ακόλουθο παράδειγμα αφαιρεί δύο τιμές διάρκειας:

BirtDuration.subtract("P1Y3M", "P13M") // επιστρέφει την τιμή P0Y2M

BirtDuration.timeInMills

Αυτή η συνάρτηση επιστρέφει το πλήθος των χιλιοστών δευτερολέπτου από μια καθορισμένη διάρκεια, ξεκινώντας από μια συγκεκριμένη ημερομηνία έναρξης. Το πλήθος των χιλιοστών δευτερολέπτου σε μια διάρκεια μπορεί να αλλάξει ανάλογα με την ημερομηνία έναρξης. Για παράδειγμα, η διάρκεια ενός μήνα μπορεί να είναι 28, 29, 30 ή 31 ημέρες, ανάλογα με την ημερομηνία έναρξης. Αν η ημερομηνία έναρξης είναι η 1η Ιανουαρίου, η συνάρτηση υπολογίζει τα χιλιοστά δευτερολέπτου μεταξύ 1ης Ιανουαρίου και 1ης Φεβρουαρίου (δεν υπολογίζεται η 1η Φεβρουαρίου), που είναι 2678400000 ή 31 ημέρες. Αν η ημερομηνία έναρξης είναι η 1η Φεβρουαρίου 2009 (δίσεκτο έτος), η συνάρτηση υπολογίζει τα χιλιοστά δευτερολέπτου μεταξύ 1ης Φεβρουαρίου και 1ης Μαρτίου τα οποία είναι 2505600000 ή 29 ημέρες.

Σύνταξη

Number BirtDuration.timeInMills( string lexicalDuration, Date startDate )

Παράμετροι

lexicalDuration

Σειρά χαρακτήρων. Μια διάρκεια της οποίας το μέγεθος θα υπολογιστεί σε χιλιοστά δευτερολέπτων.

startDate

Αντικείμενο ημερομηνίας. Αναπαριστά την ημερομηνία έναρξης.

Επιστρέφει

Αντικείμενο αριθμού. Το πλήθος των χιλιοστών δευτερολέπτου της καθορισμένης διάρκειας.

Παραδείγματα

Τα ακόλουθα παραδείγματα επιδεικνύουν το πλήθος των χιλιοστών δευτερολέπτου που επιστρέφεται για συγκεκριμένες διάρκειες και ημερομηνίες έναρξης:

BirtDuration.timeInMills( "P1Y3M10D" , "2009-01-01" ) // returns 40172400000
BirtDuration.timeInMills( "P1Y3M10D" , "2008-01-01" ) // returns 40258800000
BirtDuration.timeInMills( "PT6H45M20S" , "2009-01-01" ) // returns 24320000

BirtDuration.year

Αυτή η συνάρτηση επιστρέφει την τιμή του έτους από συγκεκριμένη διάρκεια.

Σύνταξη

integer BirtDuration.year(string lexicalDuration)

Παράμετρος

lexicalDuration

Σειρά χαρακτήρων. Μια διάρκεια από την οποία θα ανακτηθεί η τιμή του έτους.

Επιστρέφει

Ακέραιος. Ένας αριθμός που αναπαριστά την τιμή του έτους της καθορισμένης διάρκειας.

Παραδείγματα

Τα ακόλουθα παραδείγματα επιδεικνύουν τις τιμές έτους που επιστρέφονται για συγκεκριμένες διάρκειες:

BirtDuration.year( "P1Y3M15DT12H30M45S" ) // επιστρέφει την τιμή 1
BirtDuration.year( "P8DT15H" ) // επιστρέφει την τιμή 0

(c) Copyright Actuate Corporation 2013