Παραστάσεις και συναρτήσεις για το Data Factory στο Microsoft Fabric

Αυτό το άρθρο παρέχει λεπτομέρειες σχετικά με παραστάσεις και συναρτήσεις που υποστηρίζονται από το Data Factory στο Microsoft Fabric.

Παραστάσεις

Οι τιμές παράστασης στον ορισμό μπορεί να είναι λεκτικές σταθερές ή παραστάσεις που αξιολογούνται κατά τον χρόνο εκτέλεσης. Για παράδειγμα:

"value"

ή

"@pipeline().parameters.password"

Οι παραστάσεις μπορούν να εμφανίζονται οπουδήποτε σε μια τιμή συμβολοσειράς και να οδηγούν πάντα σε μια άλλη τιμή συμβολοσειράς. Εάν μια τιμή είναι παράσταση, το σώμα της παράστασης εξάγεται καταργώντας το σύμβολο (@). Εάν απαιτείται μια συμβολοσειρά λεκτικής σταθεράς που ξεκινά με @, πρέπει να εκτελείται διαφυγή χρησιμοποιώντας @@. Τα παρακάτω παραδείγματα δείχνουν τον τρόπο αξιολόγησης των παραστάσεων.

Τιμή παράστασης	Result
"παράμετροι"	Επιστρέφονται οι χαρακτήρες "παράμετροι".
"parameters[1]"	Επιστρέφονται οι χαρακτήρες 'παράμετροι[1]'.
"@@"	Επιστρέφεται μια συμβολοσειρά 1 χαρακτήρα που περιέχει "@".
" @"	Επιστρέφεται μια συμβολοσειρά 2 χαρακτήρων που περιέχει το ' @'.

Οι παραστάσεις μπορούν επίσης να εμφανίζονται μέσα σε συμβολοσειρές, χρησιμοποιώντας μια δυνατότητα που ονομάζεται παρεμβολή συμβολοσειράς όπου οι παραστάσεις περιτυλίγονται σε @{ ... }. Για παράδειγμα: "First Name: @{pipeline().parameters.firstName} Last Name: @{pipeline().parameters.lastName}"

Με τη χρήση παρεμβολής συμβολοσειράς, το αποτέλεσμα είναι πάντα μια συμβολοσειρά. Ας υποθέσουμε ότι έχω ορίσει myNumber ως 42 και myString ως foo:

Τιμή παράστασης	Result
"@pipeline().parameters.myString"	Επιστρέφει foo ως συμβολοσειρά.
"@{pipeline().parameters.myString}"	Επιστρέφει foo ως συμβολοσειρά.
"@pipeline().parameters.myNumber"	Επιστρέφει 42 ως αριθμό.
"@{pipeline().parameters.myNumber}"	Επιστρέφει 42 ως συμβολοσειρά.
"Η απάντηση είναι: @{pipeline().parameters.myNumber}"	Επιστρέφει τη συμβολοσειρά Answer is: 42.
"@concat('Η απάντηση είναι: ', string(pipeline().parameters.myNumber))"	Επιστρέφει τη συμβολοσειρά Answer is: 42
"Η απάντηση είναι: @@{pipeline().parameters.myNumber}"	Επιστρέφει τη συμβολοσειρά Answer is: @{pipeline().parameters.myNumber}.

Στις δραστηριότητες ροής ελέγχου, όπως η δραστηριότητα ForEach, μπορείτε να παρέχετε έναν πίνακα για επανάληψη για τα στοιχεία ιδιοτήτων και να τον χρησιμοποιήσετε @item() για να επαναλαμβάνετε σε μία μόνο απαρίθμηση στη δραστηριότητα ForEach. Για παράδειγμα, εάν τα στοιχεία είναι ένας πίνακας: [1, 2, 3], @item() επιστρέφει 1 στην πρώτη επανάληψη, 2 στη δεύτερη επανάληψη και 3 στην τρίτη επανάληψη. Μπορείτε επίσης να χρησιμοποιήσετε @range(0,10) την παράσταση like για να επαναλαμβάνετε 10 φορές ξεκινώντας με το 0 να τελειώνει με 9.

Μπορείτε να χρησιμοποιήσετε το @activity("όνομα δραστηριότητας") για να καταγράψετε την έξοδο δραστηριότητας και να λάβετε αποφάσεις. Εξετάστε μια δραστηριότητα web που ονομάζεται Web1. Για την τοποθέτηση του αποτελέσματος της πρώτης δραστηριότητας στο σώμα της δεύτερης, η παράσταση μοιάζει γενικά με: @activity('Web1').output ή @activity('Web1').output.data ή κάτι παρόμοιο ανάλογα με την εμφάνιση της εξόδου της πρώτης δραστηριότητας.

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

Παράδειγμα σύνθετης παράστασης

Το παρακάτω παράδειγμα εμφανίζει ένα σύνθετο παράδειγμα που αναφέρεται σε ένα δευτερεύον πεδίο με εσωτερικές πληροφορίες εξόδου δραστηριότητας. Για να αναφέρετε μια παράμετρο διοχέτευσης που αξιολογείται σε ένα δευτερεύον πεδίο, χρησιμοποιήστε τη σύνταξη [] αντί του τελεστή dot(.) (όπως στην περίπτωση των subfield1 και subfield2), ως μέρος μιας εξόδου δραστηριότητας.

@activity('*activityName*').output.*subfield1*.*subfield2*[pipeline().parameters.*subfield3*].*subfield4*

Η δημιουργία αρχείων δυναμικά και η ονομασία τους είναι ένα κοινό μοτίβο. Ας εξετάσουμε μερικά δυναμικά παραδείγματα ονοματοθεσιών αρχείων.

• Προσάρτηση ημερομηνίας σε ένα όνομα αρχείου: @concat('Test_', formatDateTime(utcnow(), 'yyyy-dd-MM'))
• Προσάρτηση ημερομηνίας/ώρας στη ζώνη ώρας πελάτη: @concat('Test_', convertFromUtc(utcnow(), 'Pacific Standard Time'))
• Προσάρτηση ώρας εναύσματος: @concat('Test_', pipeline().TriggerTime)
• Εξαγάγετε ένα προσαρμοσμένο όνομα αρχείου σε μια Ροή δεδομένων αντιστοίχισης κατά την έξοδο σε ένα μόνο αρχείο με ημερομηνία:'Test_' + toString(currentDate()) + '.csv'

Στις παραπάνω περιπτώσεις, δημιουργούνται τέσσερα δυναμικά ονόματα αρχείων ξεκινώντας με Test_.

Πρόγραμμα επεξεργασίας δυναμικού περιεχομένου

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

"@{toUpper('myData')}"

Το πρόγραμμα επεξεργασίας δυναμικού περιεχομένου μετατρέπει το παραπάνω περιεχόμενο σε παράσταση "@{toUpper('myData')}". Το αποτέλεσμα αυτής της παράστασης είναι η μορφοποιημένη συμβολοσειρά που εμφανίζεται παρακάτω.

"MYDATA"

Αντικατάσταση ειδικών χαρακτήρων

Το πρόγραμμα επεξεργασίας δυναμικού περιεχομένου ξεφεύγει αυτόματα από χαρακτήρες όπως διπλά εισαγωγικά, ανάστροφη κάθετο στο περιεχόμενό σας όταν ολοκληρώσετε την επεξεργασία. Αυτό προκαλεί πρόβλημα εάν θέλετε να αντικαταστήσετε την αλλαγή γραμμής ή τη καρτέλα χρησιμοποιώντας τα \n, \t στη συνάρτηση replace(). Μπορείτε να επεξεργαστείτε το δυναμικό περιεχόμενό σας σε προβολή κώδικα για να καταργήσετε το επιπλέον \ στην παράσταση ή μπορείτε να ακολουθήσετε τα παρακάτω βήματα για να αντικαταστήσετε ειδικούς χαρακτήρες χρησιμοποιώντας τη γλώσσα παράστασης:

1. Κωδικοποίηση διεύθυνσης URL σε σχέση με την αρχική τιμή συμβολοσειράς
2. Αντικατάσταση κωδικοποιημένης συμβολοσειράς διεύθυνσης URL, για παράδειγμα, αλλαγή γραμμής (%0A), αλλαγή παραγράφου(%0D), οριζόντια καρτέλα(%09).
3. Αποκωδικοποίηση διεύθυνσης URL

Για παράδειγμα, η μεταβλητή companyName με χαρακτήρα νέας γραμμής στην τιμή της, η παράσταση @uriComponentToString(replace(uriComponent(variables('companyName')), '%0A', '')) μπορεί να καταργήσει τον χαρακτήρα νέας γραμμής.

Contoso- Corporation

Χαρακτήρας διαφυγής μονού εισαγωγικού

Οι συναρτήσεις παράστασης χρησιμοποιούν μονά εισαγωγικά για παραμέτρους τιμής συμβολοσειράς. Χρησιμοποιήστε δύο μονά εισαγωγικά για να ξεφύγετε από έναν ' χαρακτήρα σε συναρτήσεις συμβολοσειράς. Για παράδειγμα, η παράσταση @concat('Baba', '''s ', 'book store') θα επιστρέψει κάτω από το αποτέλεσμα.

Baba's book store

Μεταβλητές εμβέλειας διοχέτευσης

Αυτές οι μεταβλητές συστήματος μπορούν να αναφέρονται οπουδήποτε στη διοχέτευση.

Όνομα μεταβλητής	Περιγραφή
@pipeline().DataFactory	Το όνομα των δεδομένων ή ο χώρος εργασίας Synapse στον οποίο εκτελείται η διοχέτευση
@pipeline().Pipeline	Το όνομα της διοχέτευσης
@pipeline().RunId	Το αναγνωριστικό της συγκεκριμένης εκτέλεσης διοχέτευσης
@pipeline().TriggerId	Αναγνωριστικό του εναύσματος που κάλεσε τη διοχέτευση
@pipeline().TriggerName	Το όνομα του εναύσματος που κάλεσε τη διοχέτευση
@pipeline().TriggerTime	Η ώρα εκτέλεσης του εναύσματος που κάλεσε τη διοχέτευση. Αυτή είναι η στιγμή κατά την οποία το έναυσμα ενεργοποιείται στην πραγματικότητα για να καλέσει την εκτέλεση της διοχέτευσης και μπορεί να διαφέρει ελαφρώς από την προγραμματισμένη ώρα του εναύσματος.
@pipeline().GroupId	Το αναγνωριστικό της ομάδας στην οποία ανήκει η εκτέλεση διοχέτευσης.
@pipeline()?. TriggeredByPipelineName	Το όνομα της διοχέτευσης που ενεργοποιεί την εκτέλεση της διοχέτευσης. Ισχύει όταν η εκτέλεση διοχέτευσης ενεργοποιείται από μια δραστηριότητα ExecutePipeline. Αξιολογείται ως Null όταν χρησιμοποιείται σε άλλες περιπτώσεις. Σημειώστε το ερωτηματικό μετά @pipeline()
@pipeline()?. TriggeredByPipelineRunId	Εκτελέστε το αναγνωριστικό της διοχέτευσης που ενεργοποιεί την εκτέλεση της διοχέτευσης. Ισχύει όταν η εκτέλεση διοχέτευσης ενεργοποιείται από μια δραστηριότητα ExecutePipeline. Αξιολογείται ως Null όταν χρησιμοποιείται σε άλλες περιπτώσεις. Σημειώστε το ερωτηματικό μετά @pipeline()

Σημείωμα

Οι μεταβλητές συστήματος ημερομηνίας/ώρας που σχετίζονται με εναύσματα (και στις δύο εμβέλειες διοχέτευσης και εναύσματος) επιστρέφουν ημερομηνίες UTC σε μορφή ISO 8601, για παράδειγμα, 2017-06-01T22:20:00.4061448Z.

Συναρτήσεις

Μπορείτε να καλέσετε συναρτήσεις μέσα σε παραστάσεις. Οι παρακάτω ενότητες παρέχουν πληροφορίες σχετικά με τις συναρτήσεις που μπορούν να χρησιμοποιηθούν σε μια παράσταση.

Συναρτήσεις ημερομηνίας

Συνάρτηση ημερομηνίας ή ώρας	Εργασία
addDays	Προσθέστε έναν αριθμό ημερών σε μια χρονική σήμανση.
addHours	Προσθέστε έναν αριθμό ωρών σε μια χρονική σήμανση.
addMinutes	Προσθέστε έναν αριθμό λεπτών σε μια χρονική σήμανση.
προσθήκη δευτερολέπτων	Προσθέστε έναν αριθμό δευτερολέπτων σε μια χρονική σήμανση.
addToTime	Προσθέστε έναν αριθμό μονάδων ώρας σε μια χρονική σήμανση. Δείτε επίσης getFutureTime.
convertFromUtc	Μετατρέψτε μια χρονική σήμανση από Συντονισμένη παγκόσμια ώρα (UTC) στη ζώνη ώρας προορισμού.
convertTimeZone	Μετατρέψτε μια χρονική σήμανση από τη ζώνη ώρας προέλευσης στη ζώνη ώρας προορισμού.
convertToUtc	Μετατρέψτε μια χρονική σήμανση από τη ζώνη ώρας προέλευσης σε Συντονισμένη παγκόσμια ώρα (UTC).
dayOfMonth	Επιστρέφει την ημέρα του στοιχείου μήνα από μια χρονική σήμανση.
dayOfWeek	Επιστρέφει το στοιχείο ημέρας της εβδομάδας από μια χρονική σήμανση.
dayOfYear	Επιστρέφει το στοιχείο ημέρας του έτους από μια χρονική σήμανση.
formatDateTime	Επιστρέφει τη χρονική σήμανση ως συμβολοσειρά σε προαιρετική μορφή.
getFutureTime	Επιστρέφει την τρέχουσα χρονική σήμανση συν τις καθορισμένες χρονικές μονάδες. Δείτε επίσης addToTime.
getPastTime	Επιστρέφει την τρέχουσα χρονική σήμανση μείον τις καθορισμένες χρονικές μονάδες. Ανατρέξτε επίσης στην ενότητα αφαίρεσηΑπό την ώρα.
startOfDay	Επιστρέψτε την αρχή της ημέρας για μια χρονική σήμανση.
startOfHour	Επιστρέψτε την αρχή της ώρας για μια χρονική σήμανση.
startOfMonth	Επιστρέψτε την αρχή του μήνα για μια χρονική σήμανση.
subtractFromTime	Αφαιρέστε έναν αριθμό μονάδων χρόνου από μια χρονική σήμανση. Δείτε επίσης getPastTime.
Κρότωνες	Επιστρέφει την ticks τιμή ιδιότητας για μια καθορισμένη χρονική σήμανση.
utcNow	Επιστρέφει την τρέχουσα χρονική σήμανση ως συμβολοσειρά.

Συναρτήσεις συμβολοσειράς

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

Συναρτήσεις συμβολοσειράς	Εργασία
Concat	Συνδυάστε δύο ή περισσότερες συμβολοσειρές και επιστρέψτε τη συνδυασμένη συμβολοσειρά.
λήγειμε	Ελέγξτε εάν μια συμβολοσειρά τελειώνει με την καθορισμένη δευτερεύουσα συμβολοσειρά.
Guid	Δημιουργήστε ένα καθολικά μοναδικό αναγνωριστικό (GUID) ως συμβολοσειρά.
indexOf	Επιστρέψτε τη θέση εκκίνησης για μια δευτερεύουσα συμβολοσειρά.
lastIndexOf	Επιστρέφει τη θέση εκκίνησης για την τελευταία εμφάνιση μιας δευτερεύουσας συμβολοσειράς.
αντικατάσταση	Αντικαταστήστε μια δευτερεύουσα συμβολοσειρά με την καθορισμένη συμβολοσειρά και επιστρέψτε την ενημερωμένη συμβολοσειρά.
διαχωρισμός	Επιστρέφει έναν πίνακα που περιέχει δευτερεύουσες συμβολοσειρές, οι οποίες διαχωρίζονται με κόμματα, από μια μεγαλύτερη συμβολοσειρά που βασίζεται σε έναν καθορισμένο χαρακτήρα οριοθέτη στην αρχική συμβολοσειρά.
startsWith	Ελέγξτε εάν μια συμβολοσειρά ξεκινά με μια συγκεκριμένη δευτερεύουσα συμβολοσειρά.
δευτερεύουσα συμβολοσειρά	Επιστρέφει χαρακτήρες από μια συμβολοσειρά, ξεκινώντας από την καθορισμένη θέση.
toLower	Επιστρέφει μια συμβολοσειρά σε πεζή μορφή.
toUpper	Επιστρέφει μια συμβολοσειρά σε μορφή κεφαλαίων.
Τελειώματα	Καταργήστε τα αρχικά και τελικά κενά διαστήματα από μια συμβολοσειρά και επιστρέψτε την ενημερωμένη συμβολοσειρά.

Συναρτήσεις συλλογής

Για να εργαστείτε με συλλογές, γενικά πίνακες, συμβολοσειρές και ορισμένες φορές λεξικά, μπορείτε να χρησιμοποιήσετε αυτές τις συναρτήσεις συλλογής.

Συνάρτηση Collection	Εργασία
Περιέχει	Ελέγξτε εάν μια συλλογή έχει ένα συγκεκριμένο στοιχείο.
empty	Ελέγξτε εάν μια συλλογή είναι κενή.
Πρώτη	Επιστρέψτε το πρώτο στοιχείο από μια συλλογή.
Διασταύρωση	Επιστρέφει μια συλλογή που διαθέτει μόνο τα κοινά στοιχεία σε όλες τις καθορισμένες συλλογές.
Συμμετάσχετε	Επιστρέφει μια συμβολοσειρά που περιέχει όλα τα στοιχεία από έναν πίνακα, τα οποία διαχωρίζονται με τον καθορισμένο χαρακτήρα.
Τελευταία	Επιστρέψτε το τελευταίο στοιχείο από μια συλλογή.
Μήκος	Επιστρέφει τον αριθμό των στοιχείων σε μια συμβολοσειρά ή πίνακα.
Παραλείψετε	Καταργήστε στοιχεία από το μπροστινό μέρος μιας συλλογής και επιστρέψτε όλα τα άλλα στοιχεία.
Λάβει	Επιστρέψτε στοιχεία από το μπροστινό μέρος μιας συλλογής.
Ένωσης	Επιστρέφει μια συλλογή που περιέχει όλα τα στοιχεία από τις καθορισμένες συλλογές.

Λογικές συναρτήσεις

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

Συνάρτηση λογικής σύγκρισης	Εργασία
and	Ελέγξτε εάν όλες οι παραστάσεις είναι true.
Ίσον	Ελέγξτε εάν και οι δύο τιμές είναι ισοδύναμες.
greater	Ελέγξτε εάν η πρώτη τιμή είναι μεγαλύτερη από τη δεύτερη τιμή.
greaterOrEquals	Ελέγξτε εάν η πρώτη τιμή είναι μεγαλύτερη ή ίση με τη δεύτερη τιμή.
Εάν	Ελέγξτε εάν μια παράσταση είναι true ή false. Με βάση το αποτέλεσμα, επιστρέψτε μια καθορισμένη τιμή.
less	Ελέγξτε εάν η πρώτη τιμή είναι μικρότερη από τη δεύτερη τιμή.
lessOrEquals	Ελέγξτε εάν η πρώτη τιμή είναι μικρότερη ή ίση από τη δεύτερη τιμή.
Δεν	Ελέγξτε εάν μια παράσταση είναι false.
or	Ελέγξτε εάν τουλάχιστον μία παράσταση είναι true.

Συναρτήσεις μετατροπής

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

• συμβολοσειρά
• integer
• κινητή υποδιαστολή
• boolean
• Συστοιχίες
• Λεξικά

Συνάρτηση μετατροπής	Εργασία
Πίνακα	Επιστρέφει έναν πίνακα από μία καθορισμένη είσοδο. Για πολλές εισόδους, ανατρέξτε στο θέμα createArray.
base64	Επιστρέψτε την έκδοση με κωδικοποίηση base64 για μια συμβολοσειρά.
base64ToBinary	Επιστρέψτε τη δυαδική έκδοση για μια συμβολοσειρά με κωδικοποίηση base64.
base64ToString	Επιστρέψτε την έκδοση συμβολοσειράς για μια συμβολοσειρά με κωδικοποίηση base64.
Δυαδική	Επιστρέφει τη δυαδική έκδοση για μια τιμή εισόδου.
Bool	Επιστρέψτε τη δυαδική έκδοση για μια τιμή εισόδου.
coalesce	Επιστρέφει την πρώτη τιμή που δεν είναι null από μία ή περισσότερες παραμέτρους.
createArray	Επιστρέφει έναν πίνακα από πολλές εισόδους.
dataUri	Επιστρέφει το URI δεδομένων για μια τιμή εισόδου.
dataUriToBinary	Επιστρέψτε τη δυαδική έκδοση για ένα URI δεδομένων.
dataUriToString	Επιστρέψτε την έκδοση συμβολοσειράς για ένα URI δεδομένων.
decodeBase64	Επιστρέψτε την έκδοση συμβολοσειράς για μια συμβολοσειρά με κωδικοποίηση base64.
decodeDataUri	Επιστρέψτε τη δυαδική έκδοση για ένα URI δεδομένων.
decodeUriComponent	Επιστρέφει μια συμβολοσειρά που αντικαθιστά τους χαρακτήρες διαφυγής με αποκωδικοποιημένες εκδόσεις.
encodeUriComponent	Επιστρέφει μια συμβολοσειρά που αντικαθιστά χαρακτήρες μη ασφαλούς διεύθυνσης URL με χαρακτήρες διαφυγής.
Επιπλέουν	Επιστρέφει έναν αριθμό κινητής υποδιαστολής για μια τιμή εισόδου.
Int	Επιστρέψτε την έκδοση ακέραιου για μια συμβολοσειρά.
Συμβολοσειρά	Επιστρέψτε την έκδοση συμβολοσειράς για μια τιμή εισόδου.
uriComponent	Επιστρέψτε την έκδοση με κωδικοποίηση URI για μια τιμή εισόδου, αντικαθιστώντας τους μη ασφαλείς χαρακτήρες URL με χαρακτήρες διαφυγής.
uriComponentToBinary	Επιστρέψτε τη δυαδική έκδοση για μια συμβολοσειρά με κωδικοποίηση URI.
uriComponentToString	Επιστρέψτε την έκδοση συμβολοσειράς για μια συμβολοσειρά με κωδικοποίηση URI.
Xml	Επιστρέφει την έκδοση XML για μια συμβολοσειρά.
Xpath	Ελέγξτε το XML για κόμβους ή τιμές που αντιστοιχούν σε μια παράσταση XPath (γλώσσα διαδρομής XML) και επιστρέψτε τους αντίστοιχους κόμβους ή τιμές.

Μαθηματικές συναρτήσεις

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

Μαθηματική συνάρτηση	Εργασία
Προσθέσετε	Επιστρέψτε το αποτέλεσμα από την προσθήκη δύο αριθμών.
Div	Επιστρέφει το αποτέλεσμα από τη διαίρεση δύο αριθμών.
Μέγιστο	Επιστρέφει την υψηλότερη τιμή από ένα σύνολο αριθμών ή έναν πίνακα.
Μίνιμουμ	Επιστρέφει τη χαμηλότερη τιμή από ένα σύνολο αριθμών ή έναν πίνακα.
Mod	Επιστρέφει το υπόλοιπο της διαίρεσης δύο αριθμών.
Mul	Επιστρέφει το προϊόν από τον πολλαπλασιασμό δύο αριθμών.
Rand	Επιστρέφει έναν τυχαίο ακέραιο από μια καθορισμένη περιοχή.
εύρος	Επιστρέφει έναν ακέραιο πίνακα που ξεκινά από έναν καθορισμένο ακέραιο.
Δευτερεύουσα	Επιστρέφει το αποτέλεσμα από την αφαίρεση του δεύτερου αριθμού από τον πρώτο αριθμό.

Αναφορά συνάρτησης

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

Προσθέσετε

Επιστρέψτε το αποτέλεσμα από την προσθήκη δύο αριθμών.

add(<summand_1>, <summand_2>)

Παράμετρος	Απαραίτητο	Type	Description
<>summand_1, <summand_2>	Όχι	Ακέραιος αριθμός, κινητή υποδιαστολή ή μεικτή	Οι αριθμοί που θα προστεθούν

Επιστρεφόμενη αξία	Τύπος	Description
<άθροισμα-αποτελέσματος>	Ακέραιος ή κινητή υποδιαστολή	Το αποτέλεσμα από την προσθήκη των καθορισμένων αριθμών

Παράδειγμα

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

add(1, 1.5)

Και επιστρέφει αυτό το αποτέλεσμα: 2.5

addDays

Προσθέστε έναν αριθμό ημερών σε μια χρονική σήμανση.

addDays('<timestamp>', <days>, '<format>'?)

Παράμετρος	Απαραίτητο	Type	Description
<Χρονική σήμανση>	Ναι	Συμβολοσειρά	Η συμβολοσειρά που περιέχει τη χρονική σήμανση
<Ημέρες>	Όχι	Integer	Ο θετικός ή αρνητικός αριθμός ημερών που θα προστεθούν
<Μορφή>	Όχι	Συμβολοσειρά	Είτε ένα προσδιοριστικό μοναδικής μορφής είτε ένα προσαρμοσμένο μοτίβο μορφής. Η προεπιλεγμένη μορφή για τη χρονική σήμανση είναι "o" (εεεε-ΜΜ-ddTHH:mm:ss.fffffffK), η οποία συμμορφώνεται με το ISO 8601 και διατηρεί τις πληροφορίες ζώνης ώρας.

Επιστρεφόμενη αξία	Τύπος	Description
<ενημερωμένη χρονική σήμανση>	Συμβολοσειρά	Η χρονική σήμανση συν τον καθορισμένο αριθμό ημερών

Παράδειγμα 1

Αυτό το παράδειγμα προσθέτει 10 ημέρες στην καθορισμένη χρονική σήμανση:

addDays('2018-03-15T13:00:00Z', 10)

Και επιστρέφει αυτό το αποτέλεσμα: "2018-03-25T00:00:0000000Z"

Παράδειγμα 2

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

addDays('2018-03-15T00:00:00Z', -5)

Και επιστρέφει αυτό το αποτέλεσμα: "2018-03-10T00:00:0000000Z"

addHours

Προσθέστε έναν αριθμό ωρών σε μια χρονική σήμανση.

addHours('<timestamp>', <hours>, '<format>'?)

Παράμετρος	Απαραίτητο	Type	Description
<Χρονική σήμανση>	Ναι	Συμβολοσειρά	Η συμβολοσειρά που περιέχει τη χρονική σήμανση
<Ώρες>	Όχι	Integer	Ο θετικός ή αρνητικός αριθμός ωρών που θα προστεθούν
<Μορφή>	Όχι	Συμβολοσειρά	Είτε ένα προσδιοριστικό μοναδικής μορφής είτε ένα προσαρμοσμένο μοτίβο μορφής. Η προεπιλεγμένη μορφή για τη χρονική σήμανση είναι "o" (εεεε-ΜΜ-ddTHH:mm:ss.fffffffK), η οποία συμμορφώνεται με το ISO 8601 και διατηρεί τις πληροφορίες ζώνης ώρας.

Επιστρεφόμενη αξία	Τύπος	Description
<ενημερωμένη χρονική σήμανση>	Συμβολοσειρά	Η χρονική σήμανση συν τον καθορισμένο αριθμό ωρών

Παράδειγμα 1

Αυτό το παράδειγμα προσθέτει 10 ώρες στην καθορισμένη χρονική σήμανση:

addHours('2018-03-15T00:00:00Z', 10)

Και επιστρέφει αυτό το αποτέλεσμα: "2018-03-15T10:00:0000000Z"

Παράδειγμα 2

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

addHours('2018-03-15T15:00:00Z', -5)

Και επιστρέφει αυτό το αποτέλεσμα: "2018-03-15T10:00:0000000Z"

addMinutes

Προσθέστε έναν αριθμό λεπτών σε μια χρονική σήμανση.

addMinutes('<timestamp>', <minutes>, '<format>'?)

Παράμετρος	Απαραίτητο	Type	Description
<Χρονική σήμανση>	Ναι	Συμβολοσειρά	Η συμβολοσειρά που περιέχει τη χρονική σήμανση
<Λεπτά>	Όχι	Integer	Ο θετικός ή αρνητικός αριθμός λεπτών που θα προστεθούν
<Μορφή>	Όχι	Συμβολοσειρά	Είτε ένα προσδιοριστικό μοναδικής μορφής είτε ένα προσαρμοσμένο μοτίβο μορφής. Η προεπιλεγμένη μορφή για τη χρονική σήμανση είναι "o" (εεεε-ΜΜ-ddTHH:mm:ss.fffffffK), η οποία συμμορφώνεται με το ISO 8601 και διατηρεί τις πληροφορίες ζώνης ώρας.

Επιστρεφόμενη αξία	Τύπος	Description
<ενημερωμένη χρονική σήμανση>	Συμβολοσειρά	Η χρονική σήμανση συν τον καθορισμένο αριθμό λεπτών

Παράδειγμα 1

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

addMinutes('2018-03-15T00:10:00Z', 10)

Και επιστρέφει αυτό το αποτέλεσμα: "2018-03-15T00:20:00.0000000Z"

Παράδειγμα 2

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

addMinutes('2018-03-15T00:20:00Z', -5)

Και επιστρέφει αυτό το αποτέλεσμα: "2018-03-15T00:15:00.0000000Z"

προσθήκη δευτερολέπτων

Προσθέστε έναν αριθμό δευτερολέπτων σε μια χρονική σήμανση.

addSeconds('<timestamp>', <seconds>, '<format>'?)

Παράμετρος	Απαραίτητο	Type	Description
<Χρονική σήμανση>	Ναι	Συμβολοσειρά	Η συμβολοσειρά που περιέχει τη χρονική σήμανση
<Δευτερόλεπτα>	Όχι	Integer	Ο θετικός ή αρνητικός αριθμός δευτερολέπτων για προσθήκη
<Μορφή>	Όχι	Συμβολοσειρά	Είτε ένα προσδιοριστικό μοναδικής μορφής είτε ένα προσαρμοσμένο μοτίβο μορφής. Η προεπιλεγμένη μορφή για τη χρονική σήμανση είναι "o" (εεεε-ΜΜ-ddTHH:mm:ss.fffffffK), η οποία συμμορφώνεται με το ISO 8601 και διατηρεί τις πληροφορίες ζώνης ώρας.

Επιστρεφόμενη αξία	Τύπος	Description
<ενημερωμένη χρονική σήμανση>	Συμβολοσειρά	Η χρονική σήμανση συν τον καθορισμένο αριθμό δευτερολέπτων

Παράδειγμα 1

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

addSeconds('2018-03-15T00:00:00Z', 10)

Και επιστρέφει αυτό το αποτέλεσμα: "2018-03-15T00:00:10.0000000Z"

Παράδειγμα 2

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

addSeconds('2018-03-15T00:00:30Z', -5)

Και επιστρέφει αυτό το αποτέλεσμα: "2018-03-15T00:00:25.0000000Z"

addToTime

Προσθέστε έναν αριθμό μονάδων ώρας σε μια χρονική σήμανση. Δείτε επίσης getFutureTime().

addToTime('<timestamp>', <interval>, '<timeUnit>', '<format>'?)

Παράμετρος	Απαραίτητο	Type	Description
<Χρονική σήμανση>	Ναι	Συμβολοσειρά	Η συμβολοσειρά που περιέχει τη χρονική σήμανση
<Διάστημα>	Όχι	Integer	Ο αριθμός καθορισμένων μονάδων ώρας που θα προστεθούν
<timeUnit>	Ναι	Συμβολοσειρά	Η μονάδα χρόνου που θα χρησιμοποιηθεί με το διάστημα: "Second", "Minute", "Hour", "Day", "Week", "Month", "Year"
<Μορφή>	Όχι	Συμβολοσειρά	Είτε ένα προσδιοριστικό μοναδικής μορφής είτε ένα προσαρμοσμένο μοτίβο μορφής. Η προεπιλεγμένη μορφή για τη χρονική σήμανση είναι "o" (εεεε-ΜΜ-ddTHH:mm:ss.fffffffK), η οποία συμμορφώνεται με το ISO 8601 και διατηρεί τις πληροφορίες ζώνης ώρας.

Επιστρεφόμενη αξία	Τύπος	Description
<ενημερωμένη χρονική σήμανση>	Συμβολοσειρά	Η χρονική σήμανση συν τον καθορισμένο αριθμό μονάδων χρόνου

Παράδειγμα 1

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

addToTime('2018-01-01T00:00:00Z', 1, 'Day')

Και επιστρέφει αυτό το αποτέλεσμα: "2018-01-02T00:00:00.0000000Z"

Παράδειγμα 2

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

addToTime('2018-01-01T00:00:00Z', 1, 'Day', 'D')

Επίσης, επιστρέφει το αποτέλεσμα χρησιμοποιώντας την προαιρετική μορφή "D": "Tuesday, January 2, 2018"

και

Ελέγξτε εάν και οι δύο παραστάσεις είναι true. Επιστρέφει την τιμή true όταν και οι δύο παραστάσεις είναι true ή επιστρέφει false όταν τουλάχιστον μία παράσταση είναι false.

and(<expression1>, <expression2>)

Παράμετρος	Απαραίτητο	Type	Description
<expression1>, <expression2>	Όχι	Boolean	Οι παραστάσεις για έλεγχο

Επιστρεφόμενη αξία	Τύπος	Description
true ή false	Boolean	Επιστρέφει την τιμή true όταν και οι δύο παραστάσεις είναι true. Επιστρέφει false όταν τουλάχιστον μία παράσταση είναι false.

Παράδειγμα 1

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

and(true, true)
and(false, true)
and(false, false)

Και επιστρέφει αυτά τα αποτελέσματα:

• Πρώτο παράδειγμα: Και οι δύο παραστάσεις είναι true, επομένως επιστρέφει true.
• Δεύτερο παράδειγμα: Μία παράσταση είναι false, επομένως επιστρέφει false.
• Τρίτο παράδειγμα: Και οι δύο παραστάσεις είναι false, επομένως επιστρέφει false.

Παράδειγμα 2

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

and(equals(1, 1), equals(2, 2))
and(equals(1, 1), equals(1, 2))
and(equals(1, 2), equals(1, 3))

Και επιστρέφει αυτά τα αποτελέσματα:

• Πρώτο παράδειγμα: Και οι δύο παραστάσεις είναι true, επομένως επιστρέφει true.
• Δεύτερο παράδειγμα: Μία παράσταση είναι false, επομένως επιστρέφει false.
• Τρίτο παράδειγμα: Και οι δύο παραστάσεις είναι false, επομένως επιστρέφει false.

πίνακας

Επιστρέφει έναν πίνακα από μία καθορισμένη είσοδο. Για πολλές εισόδους, ανατρέξτε στο θέμα createArray().

array('<value>')

Παράμετρος	Απαραίτητο	Type	Description
<Τιμή>	Ναι	Συμβολοσειρά	Η συμβολοσειρά για τη δημιουργία ενός πίνακα

Επιστρεφόμενη αξία	Τύπος	Description
[<τιμή>]	Πίνακας	Ένας πίνακας που περιέχει τη μοναδική καθορισμένη είσοδο

Παράδειγμα

Αυτό το παράδειγμα δημιουργεί έναν πίνακα από τη συμβολοσειρά "hello":

array('hello')

Και επιστρέφει αυτό το αποτέλεσμα: ["hello"]

base64

Επιστρέψτε την έκδοση με κωδικοποίηση base64 για μια συμβολοσειρά.

base64('<value>')

Παράμετρος	Απαραίτητο	Type	Description
<Τιμή>	Ναι	Συμβολοσειρά	Η συμβολοσειρά εισόδου

Επιστρεφόμενη αξία	Τύπος	Description
<base64-string>	Συμβολοσειρά	Η έκδοση με κωδικοποίηση base64 για τη συμβολοσειρά εισόδου

Παράδειγμα

Αυτό το παράδειγμα μετατρέπει τη συμβολοσειρά "hello" σε μια συμβολοσειρά με κωδικοποίηση base64:

base64('hello')

Και επιστρέφει αυτό το αποτέλεσμα: "aGVsbG8="

base64ToBinary

Επιστρέψτε τη δυαδική έκδοση για μια συμβολοσειρά με κωδικοποίηση base64.

base64ToBinary('<value>')

Παράμετρος	Απαραίτητο	Type	Description
<Τιμή>	Ναι	Συμβολοσειρά	Η συμβολοσειρά με κωδικοποίηση base64 για μετατροπή

Επιστρεφόμενη αξία	Τύπος	Description
<δυαδική-για-base64-συμβολοσειρά>	Συμβολοσειρά	Η δυαδική έκδοση για τη συμβολοσειρά με κωδικοποίηση base64

Παράδειγμα

Αυτό το παράδειγμα μετατρέπει τη συμβολοσειρά με κωδικοποίηση base64"aGVsbG8=" σε μια δυαδική συμβολοσειρά:

base64ToBinary('aGVsbG8=')

Και επιστρέφει αυτό το αποτέλεσμα:

"0110000101000111010101100111001101100010010001110011100000111101"

base64ToString

Επιστρέψτε την έκδοση συμβολοσειράς για μια συμβολοσειρά με κωδικοποίηση base64, αποκωδικοποιώντας ουσιαστικά τη συμβολοσειρά base64. Χρησιμοποιήστε αυτή τη συνάρτηση αντί να αποκωδικοποιήσετε τοBase64(). Παρόλο που και οι δύο συναρτήσεις λειτουργούν με τον ίδιο τρόπο, base64ToString() είναι προτιμότερο.

base64ToString('<value>')

Παράμετρος	Απαραίτητο	Type	Description
<Τιμή>	Ναι	Συμβολοσειρά	Η συμβολοσειρά με κωδικοποίηση base64 για αποκωδικοποίηση

Επιστρεφόμενη αξία	Τύπος	Description
<αποκωδικοποιημένο-base64-συμβολοσειρά>	Συμβολοσειρά	Η έκδοση συμβολοσειράς για μια συμβολοσειρά με κωδικοποίηση base64

Παράδειγμα

Αυτό το παράδειγμα μετατρέπει τη συμβολοσειρά με κωδικοποίηση base64"aGVsbG8=" σε μια συμβολοσειρά:

base64ToString('aGVsbG8=')

Και επιστρέφει αυτό το αποτέλεσμα: "hello"

Δυαδική

Επιστρέψτε τη δυαδική έκδοση για μια συμβολοσειρά.

binary('<value>')

Παράμετρος	Απαραίτητο	Type	Description
<Τιμή>	Ναι	Συμβολοσειρά	Η συμβολοσειρά προς μετατροπή

Επιστρεφόμενη αξία	Τύπος	Description
<δυαδική-για-τιμή-εισόδου>	Συμβολοσειρά	Η δυαδική έκδοση για την καθορισμένη συμβολοσειρά

Παράδειγμα

Αυτό το παράδειγμα μετατρέπει τη συμβολοσειρά "hello" σε δυαδική συμβολοσειρά:

binary('hello')

Και επιστρέφει αυτό το αποτέλεσμα:

"0110100001100101011011000110110001101111"

δυαδ.

Επιστρέψτε τη δυαδική έκδοση για μια τιμή.

bool(<value>)

Παράμετρος	Απαραίτητο	Type	Description
<Τιμή>	Όχι	Any	Η τιμή προς μετατροπή

Επιστρεφόμενη αξία	Τύπος	Description
true ή false	Boolean	Η δυαδική έκδοση για την καθορισμένη τιμή

Παράδειγμα

Αυτά τα παραδείγματα μετατρέπουν τις καθορισμένες τιμές σε δυαδικές τιμές:

bool(1)
bool(0)

Και επιστρέφει αυτά τα αποτελέσματα:

• Πρώτο παράδειγμα: true
• Δεύτερο παράδειγμα: false

coalesce

Επιστρέφει την πρώτη τιμή που δεν είναι null από μία ή περισσότερες παραμέτρους. Οι κενές συμβολοσειρές, οι κενές πίνακες και τα κενά αντικείμενα δεν είναι null.

coalesce(<object_1>, <object_2>, ...)

Παράμετρος	Απαραίτητο	Type	Description
<>object_1, <object_2>, ...	Όχι	Οποιοσδήποτε, μπορεί να συνδυάσει τύπους	Ένα ή περισσότερα στοιχεία για έλεγχο για τιμή null

Επιστρεφόμενη αξία	Τύπος	Description
<πρώτο-μη-null-στοιχείο>	Any	Το πρώτο στοιχείο ή τιμή που δεν είναι null. Εάν όλες οι παράμετροι είναι null, αυτή η συνάρτηση επιστρέφει την τιμή null.

Παράδειγμα

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

coalesce(null, true, false)
coalesce(null, 'hello', 'world')
coalesce(null, null, null)

Και επιστρέφει αυτά τα αποτελέσματα:

• Πρώτο παράδειγμα: true
• Δεύτερο παράδειγμα: "hello"
• Τρίτο παράδειγμα: null

concat

Συνδυάστε δύο ή περισσότερες συμβολοσειρές και επιστρέψτε τη συνδυασμένη συμβολοσειρά.

concat('<text1>', '<text2>', ...)

Παράμετρος	Απαραίτητο	Type	Description
<text1>, <text2>, ...	Ναι	Συμβολοσειρά	Τουλάχιστον δύο συμβολοσειρές για συνδυασμό

Επιστρεφόμενη αξία	Τύπος	Description
<text1text2...>	Συμβολοσειρά	Η συμβολοσειρά που δημιουργήθηκε από τις συνδυασμένες συμβολοσειρές εισόδου

Παράδειγμα

Αυτό το παράδειγμα συνδυάζει τις συμβολοσειρές "Hello" και "World":

concat('Hello', 'World')

Και επιστρέφει αυτό το αποτέλεσμα: "HelloWorld"

περιέχει

Ελέγξτε εάν μια συλλογή έχει ένα συγκεκριμένο στοιχείο. Επιστρέφει την τιμή true όταν βρεθεί το στοιχείο ή επιστρέφει "false" όταν δεν βρεθεί. Αυτή η συνάρτηση κάνει διάκριση πεζών-κεφαλαίων.

contains('<collection>', '<value>')
contains([<collection>], '<value>')

Συγκεκριμένα, αυτή η συνάρτηση λειτουργεί με αυτούς τους τύπους συλλογής:

• Μια συμβολοσειρά για την εύρεση μιας δευτερεύουσας συμβολοσειράς
• Ένας πίνακας για την εύρεση μιας τιμής
• Ένα λεξικό για εύρεση κλειδιού

Παράμετρος	Απαραίτητο	Type	Description
<Συλλογή>	Όχι	Συμβολοσειρά, Πίνακας ή Λεξικό	Η συλλογή που θα ελέγξετε
<Τιμή>	Όχι	Συμβολοσειρά, Πίνακας ή Λεξικό, αντίστοιχα	Το στοιχείο προς εύρεση

Επιστρεφόμενη αξία	Τύπος	Description
true ή false	Boolean	Επιστρέφει την τιμή true όταν βρεθεί το στοιχείο. Επιστρέψτε false όταν δεν βρεθεί.

Παράδειγμα 1

Αυτό το παράδειγμα ελέγχει τη συμβολοσειρά "hello world" για τη δευτερεύουσα συμβολοσειρά "world" και επιστρέφει την τιμή true:

contains('hello world', 'world')

Παράδειγμα 2

Αυτό το παράδειγμα ελέγχει τη συμβολοσειρά "hello world" για τη δευτερεύουσα συμβολοσειρά "σύμπαν" και επιστρέφει false:

contains('hello world', 'universe')

convertFromUtc

Μετατρέψτε μια χρονική σήμανση από Συντονισμένη παγκόσμια ώρα (UTC) στη ζώνη ώρας προορισμού.

convertFromUtc('<timestamp>', '<destinationTimeZone>', '<format>'?)

Παράμετρος	Απαραίτητο	Type	Description
<Χρονική σήμανση>	Ναι	Συμβολοσειρά	Η συμβολοσειρά που περιέχει τη χρονική σήμανση
<destinationTimeZone>	Ναι	Συμβολοσειρά	Το όνομα για τη ζώνη ώρας προορισμού. Για τα ονόματα ζώνης ώρας, ανατρέξτε στο θέμα Τιμές ζώνης ώρας Microsoft, αλλά ίσως χρειαστεί να καταργήσετε τυχόν σημεία στίξης από το όνομα ζώνης ώρας.
<Μορφή>	Όχι	Συμβολοσειρά	Είτε ένα προσδιοριστικό μοναδικής μορφής είτε ένα προσαρμοσμένο μοτίβο μορφής. Η προεπιλεγμένη μορφή για τη χρονική σήμανση είναι "o" (εεεε-ΜΜ-ddTHH:mm:ss.fffffffK), η οποία συμμορφώνεται με το ISO 8601 και διατηρεί τις πληροφορίες ζώνης ώρας.

Επιστρεφόμενη αξία	Τύπος	Description
<μετατροπή-χρονική σήμανση>	Συμβολοσειρά	Η χρονική σήμανση που μετατρέπεται στη ζώνη ώρας προορισμού

Παράδειγμα 1

Αυτό το παράδειγμα μετατρέπει μια χρονική σήμανση στην καθορισμένη ζώνη ώρας:

convertFromUtc('2018-01-01T08:00:00.0000000Z', 'Pacific Standard Time')

Και επιστρέφει αυτό το αποτέλεσμα: "2018-01-01T00:00:00Z"

Παράδειγμα 2

Αυτό το παράδειγμα μετατρέπει μια χρονική σήμανση στην καθορισμένη ζώνη ώρας και μορφή:

convertFromUtc('2018-01-01T08:00:00.0000000Z', 'Pacific Standard Time', 'D')

Και επιστρέφει αυτό το αποτέλεσμα: "Monday, January 1, 2018"

convertTimeZone

Μετατρέψτε μια χρονική σήμανση από τη ζώνη ώρας προέλευσης στη ζώνη ώρας προορισμού.

convertTimeZone('<timestamp>', '<sourceTimeZone>', '<destinationTimeZone>', '<format>'?)

Παράμετρος	Απαραίτητο	Type	Description
<Χρονική σήμανση>	Ναι	Συμβολοσειρά	Η συμβολοσειρά που περιέχει τη χρονική σήμανση
<sourceTimeZone>	Ναι	Συμβολοσειρά	Το όνομα για τη ζώνη ώρας προέλευσης. Για τα ονόματα ζώνης ώρας, ανατρέξτε στο θέμα Τιμές ζώνης ώρας Microsoft, αλλά ίσως χρειαστεί να καταργήσετε τυχόν σημεία στίξης από το όνομα ζώνης ώρας.
<destinationTimeZone>	Ναι	Συμβολοσειρά	Το όνομα για τη ζώνη ώρας προορισμού. Για τα ονόματα ζώνης ώρας, ανατρέξτε στο θέμα Τιμές ζώνης ώρας Microsoft, αλλά ίσως χρειαστεί να καταργήσετε τυχόν σημεία στίξης από το όνομα ζώνης ώρας.
<Μορφή>	Όχι	Συμβολοσειρά	Είτε ένα προσδιοριστικό μοναδικής μορφής είτε ένα προσαρμοσμένο μοτίβο μορφής. Η προεπιλεγμένη μορφή για τη χρονική σήμανση είναι "o" (εεεε-ΜΜ-ddTHH:mm:ss.fffffffK), η οποία συμμορφώνεται με το ISO 8601 και διατηρεί τις πληροφορίες ζώνης ώρας.

Επιστρεφόμενη αξία	Τύπος	Description
<μετατροπή-χρονική σήμανση>	Συμβολοσειρά	Η χρονική σήμανση που μετατρέπεται στη ζώνη ώρας προορισμού

Παράδειγμα 1

Αυτό το παράδειγμα μετατρέπει τη ζώνη ώρας προέλευσης στη ζώνη ώρας προορισμού:

convertTimeZone('2018-01-01T08:00:00.0000000Z', 'UTC', 'Pacific Standard Time')

Και επιστρέφει αυτό το αποτέλεσμα: "2018-01-01T00:00:00.0000000"

Παράδειγμα 2

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

convertTimeZone('2018-01-01T08:00:00.0000000Z', 'UTC', 'Pacific Standard Time', 'D')

Και επιστρέφει αυτό το αποτέλεσμα: "Monday, January 1, 2018"

convertToUtc

Μετατρέψτε μια χρονική σήμανση από τη ζώνη ώρας προέλευσης σε Συντονισμένη παγκόσμια ώρα (UTC).

convertToUtc('<timestamp>', '<sourceTimeZone>', '<format>'?)

Παράμετρος	Απαραίτητο	Type	Description
<Χρονική σήμανση>	Ναι	Συμβολοσειρά	Η συμβολοσειρά που περιέχει τη χρονική σήμανση
<sourceTimeZone>	Ναι	Συμβολοσειρά	Το όνομα για τη ζώνη ώρας προέλευσης. Για τα ονόματα ζώνης ώρας, ανατρέξτε στο θέμα Τιμές ζώνης ώρας Microsoft, αλλά ίσως χρειαστεί να καταργήσετε τυχόν σημεία στίξης από το όνομα ζώνης ώρας.
<Μορφή>	Όχι	Συμβολοσειρά	Είτε ένα προσδιοριστικό μοναδικής μορφής είτε ένα προσαρμοσμένο μοτίβο μορφής. Η προεπιλεγμένη μορφή για τη χρονική σήμανση είναι "o" (εεεε-ΜΜ-ddTHH:mm:ss.fffffffK), η οποία συμμορφώνεται με το ISO 8601 και διατηρεί τις πληροφορίες ζώνης ώρας.

Επιστρεφόμενη αξία	Τύπος	Description
<μετατροπή-χρονική σήμανση>	Συμβολοσειρά	Η χρονική σήμανση που μετατρέπεται σε UTC

Παράδειγμα 1

Αυτό το παράδειγμα μετατρέπει μια χρονική σήμανση σε UTC:

convertToUtc('01/01/2018 00:00:00', 'Pacific Standard Time')

Και επιστρέφει αυτό το αποτέλεσμα: "2018-01-01T08:00:00.0000000Z"

Παράδειγμα 2

Αυτό το παράδειγμα μετατρέπει μια χρονική σήμανση σε UTC:

convertToUtc('01/01/2018 00:00:00', 'Pacific Standard Time', 'D')

Και επιστρέφει αυτό το αποτέλεσμα: "Monday, January 1, 2018"

createArray

Επιστρέφει έναν πίνακα από πολλές εισόδους. Για μεμονωμένους πίνακες εισόδου, ανατρέξτε στην παράμετρο array().

createArray('<object1>', '<object2>', ...)

Παράμετρος	Απαραίτητο	Type	Description
<object1>, <object2>, ...	Όχι	Οποιαδήποτε, αλλά όχι μικτή	Τουλάχιστον δύο στοιχεία για τη δημιουργία του πίνακα

Επιστρεφόμενη αξία	Τύπος	Description
[<object1>, <object2>, ...]	Πίνακας	Ο πίνακας που δημιουργήθηκε από όλα τα στοιχεία εισόδου

Παράδειγμα

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

createArray('h', 'e', 'l', 'l', 'o')

Και επιστρέφει αυτό το αποτέλεσμα: ["h", "e", "l", "l", "o"]

dataUri

Επιστρέφει ένα ενιαίο αναγνωριστικό πόρου δεδομένων (URI) για μια συμβολοσειρά.

dataUri('<value>')

Παράμετρος	Απαραίτητο	Type	Description
<Τιμή>	Ναι	Συμβολοσειρά	Η συμβολοσειρά προς μετατροπή

Επιστρεφόμενη αξία	Τύπος	Description
<data-uri>	Συμβολοσειρά	Το URI δεδομένων για τη συμβολοσειρά εισόδου

Παράδειγμα

Αυτό το παράδειγμα δημιουργεί ένα URI δεδομένων για τη συμβολοσειρά "hello":

dataUri('hello')

Και επιστρέφει αυτό το αποτέλεσμα: "data:text/plain;charset=utf-8;base64,aGVsbG8="

dataUriToBinary

Επιστρέφει τη δυαδική έκδοση για ένα ενιαίο αναγνωριστικό πόρου δεδομένων (URI). Χρησιμοποιήστε αυτή τη συνάρτηση αντί για αποκωδικοποίησηDataUri(). Παρόλο που και οι δύο συναρτήσεις λειτουργούν με τον ίδιο τρόπο, dataUriBinary() είναι προτιμότερο.

dataUriToBinary('<value>')

Παράμετρος	Απαραίτητο	Type	Description
<Τιμή>	Ναι	Συμβολοσειρά	Το URI δεδομένων προς μετατροπή

Επιστρεφόμενη αξία	Τύπος	Description
<δυαδικό-για-δεδομένα-uri>	Συμβολοσειρά	Η δυαδική έκδοση για το URI δεδομένων

Παράδειγμα

Αυτό το παράδειγμα δημιουργεί μια δυαδική έκδοση για αυτό το URI δεδομένων:

dataUriToBinary('data:text/plain;charset=utf-8;base64,aGVsbG8=')

Και επιστρέφει αυτό το αποτέλεσμα:

"01100100011000010111010001100001001110100111010001100101011110000111010000101111011100000 1101100011000010110100101101110001110110110001101101000011000010111001001110011011001010111 0100001111010111010101110100011001100010110100111000001110110110001001100001011100110110010 10011011000110100001011000110000101000111010101100111001101100010010001110011100000111101"

dataUriToString

Επιστρέφει την έκδοση συμβολοσειράς για ένα ενιαίο αναγνωριστικό πόρου δεδομένων (URI).

dataUriToString('<value>')

Παράμετρος	Απαραίτητο	Type	Description
<Τιμή>	Ναι	Συμβολοσειρά	Το URI δεδομένων προς μετατροπή

Επιστρεφόμενη αξία	Τύπος	Description
<συμβολοσειρά-για-δεδομένα-uri>	Συμβολοσειρά	Η έκδοση συμβολοσειράς για το URI δεδομένων

Παράδειγμα

Αυτό το παράδειγμα δημιουργεί μια συμβολοσειρά για αυτό το URI δεδομένων:

dataUriToString('data:text/plain;charset=utf-8;base64,aGVsbG8=')

Και επιστρέφει αυτό το αποτέλεσμα: "hello"

dayOfMonth

Επιστρέφει την ημέρα του μήνα από μια χρονική σήμανση.

dayOfMonth('<timestamp>')

Παράμετρος	Απαραίτητο	Type	Description
<Χρονική σήμανση>	Ναι	Συμβολοσειρά	Η συμβολοσειρά που περιέχει τη χρονική σήμανση

Επιστρεφόμενη αξία	Τύπος	Description
<ημέρα του μήνα>	Integer	Η ημέρα του μήνα από την καθορισμένη χρονική σήμανση

Παράδειγμα

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

dayOfMonth('2018-03-15T13:27:36Z')

Και επιστρέφει αυτό το αποτέλεσμα: 15

dayOfWeek

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

dayOfWeek('<timestamp>')

Παράμετρος	Απαραίτητο	Type	Description
<Χρονική σήμανση>	Ναι	Συμβολοσειρά	Η συμβολοσειρά που περιέχει τη χρονική σήμανση

Επιστρεφόμενη αξία	Τύπος	Description
<ημέρα της εβδομάδας>	Integer	Η ημέρα της εβδομάδας από την καθορισμένη χρονική σήμανση όπου η Κυριακή είναι 0, η Δευτέρα είναι 1 και ούτω καθεξής

Παράδειγμα

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

dayOfWeek('2018-03-15T13:27:36Z')

Και επιστρέφει αυτό το αποτέλεσμα: 3

dayOfYear

Επιστρέφει την ημέρα του έτους από μια χρονική σήμανση.

dayOfYear('<timestamp>')

Παράμετρος	Απαραίτητο	Type	Description
<Χρονική σήμανση>	Ναι	Συμβολοσειρά	Η συμβολοσειρά που περιέχει τη χρονική σήμανση

Επιστρεφόμενη αξία	Τύπος	Description
<ημέρα του έτους>	Integer	Η ημέρα του έτους από την καθορισμένη χρονική σήμανση

Παράδειγμα

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

dayOfYear('2018-03-15T13:27:36Z')

Και επιστρέφει αυτό το αποτέλεσμα: 74

decodeBase64

Επιστρέψτε την έκδοση συμβολοσειράς για μια συμβολοσειρά με κωδικοποίηση base64, αποκωδικοποιώντας ουσιαστικά τη συμβολοσειρά base64. Εξετάστε το ενδεχόμενο να χρησιμοποιήσετε το base64ToString() αντί για decodeBase64()το . Παρόλο που και οι δύο συναρτήσεις λειτουργούν με τον ίδιο τρόπο, base64ToString() είναι προτιμότερο.

decodeBase64('<value>')

Παράμετρος	Απαραίτητο	Type	Description
<Τιμή>	Ναι	Συμβολοσειρά	Η συμβολοσειρά με κωδικοποίηση base64 για αποκωδικοποίηση

Επιστρεφόμενη αξία	Τύπος	Description
<αποκωδικοποιημένο-base64-συμβολοσειρά>	Συμβολοσειρά	Η έκδοση συμβολοσειράς για μια συμβολοσειρά με κωδικοποίηση base64

Παράδειγμα

Αυτό το παράδειγμα δημιουργεί μια συμβολοσειρά για μια συμβολοσειρά με κωδικοποίηση base64:

decodeBase64('aGVsbG8=')

Και επιστρέφει αυτό το αποτέλεσμα: "hello"

decodeDataUri

Επιστρέφει τη δυαδική έκδοση για ένα ενιαίο αναγνωριστικό πόρου δεδομένων (URI). Εξετάστε τη χρήση του dataUriToBinary(), αντί decodeDataUri()για το . Παρόλο που και οι δύο συναρτήσεις λειτουργούν με τον ίδιο τρόπο, dataUriToBinary() είναι προτιμότερο.

decodeDataUri('<value>')

Παράμετρος	Απαραίτητο	Type	Description
<Τιμή>	Ναι	Συμβολοσειρά	Η συμβολοσειρά URI δεδομένων για αποκωδικοποίηση

Επιστρεφόμενη αξία	Τύπος	Description
<δυαδικό-για-δεδομένα-uri>	Συμβολοσειρά	Η δυαδική έκδοση για μια συμβολοσειρά URI δεδομένων

Παράδειγμα

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

decodeDataUri('data:text/plain;charset=utf-8;base64,aGVsbG8=')

Και επιστρέφει αυτό το αποτέλεσμα:

"01100100011000010111010001100001001110100111010001100101011110000111010000101111011100000 1101100011000010110100101101110001110110110001101101000011000010111001001110011011001010111 0100001111010111010101110100011001100010110100111000001110110110001001100001011100110110010 10011011000110100001011000110000101000111010101100111001101100010010001110011100000111101"

decodeUriComponent

Επιστρέφει μια συμβολοσειρά που αντικαθιστά τους χαρακτήρες διαφυγής με αποκωδικοποιημένες εκδόσεις.

decodeUriComponent('<value>')

Παράμετρος	Απαραίτητο	Type	Description
<Τιμή>	Ναι	Συμβολοσειρά	Η συμβολοσειρά με τους χαρακτήρες διαφυγής για αποκωδικοποίηση

Επιστρεφόμενη αξία	Τύπος	Description
<αποκωδικοποιημένο-uri>	Συμβολοσειρά	Η ενημερωμένη συμβολοσειρά με τους αποκωδικοποιημένους χαρακτήρες διαφυγής

Παράδειγμα

Αυτό το παράδειγμα αντικαθιστά τους χαρακτήρες διαφυγής σε αυτήν τη συμβολοσειρά με αποκωδικοποιημένες εκδόσεις:

decodeUriComponent('http%3A%2F%2Fcontoso.com')

Και επιστρέφει αυτό το αποτέλεσμα: "https://contoso.com"

Div

Επιστρέφει το αποτέλεσμα ακέραιου από τη διαίρεση δύο αριθμών. Για να λάβετε το υπόλοιπο αποτέλεσμα, ανατρέξτε στο mod ().

div(<dividend>, <divisor>)

Παράμετρος	Απαραίτητο	Type	Description
<Μέρισμα>	Όχι	Ακέραιος ή κινητή υποδιαστολή	Ο αριθμός προς διαίρεση με τον διαιρέτη
<Διαιρέτης>	Όχι	Ακέραιος ή κινητή υποδιαστολή	Ο αριθμός που διαιρεί το μέρισμα, αλλά δεν μπορεί να είναι 0

Επιστρεφόμενη αξία	Τύπος	Description
<αποτέλεσμα-πηλίκου>	Integer	Το ακέραιο αποτέλεσμα από τη διαίρεση του πρώτου αριθμού με τον δεύτερο αριθμό

Παράδειγμα

Και τα δύο παραδείγματα διαιρούν τον πρώτο αριθμό με τον δεύτερο αριθμό:

div(10, 5)
div(11, 5)

Και επιστρέψτε αυτό το αποτέλεσμα: 2

encodeUriComponent

Επιστρέφει μια έκδοση με κωδικοποίηση ενιαίου αναγνωριστικού πόρου (URI) για μια συμβολοσειρά, αντικαθιστώντας τους μη ασφαλείς χαρακτήρες URL με χαρακτήρες διαφυγής. Εξετάστε τη χρήση του uriComponent(), αντί encodeUriComponent()για το . Παρόλο που και οι δύο συναρτήσεις λειτουργούν με τον ίδιο τρόπο, uriComponent() είναι προτιμότερο.

encodeUriComponent('<value>')

Παράμετρος	Απαραίτητο	Type	Description
<Τιμή>	Ναι	Συμβολοσειρά	Η συμβολοσειρά προς μετατροπή σε μορφή με κωδικοποίηση URI

Επιστρεφόμενη αξία	Τύπος	Description
<κωδικοποιημένο-uri>	Συμβολοσειρά	Η συμβολοσειρά με κωδικοποίηση URI με χαρακτήρες διαφυγής

Παράδειγμα

Αυτό το παράδειγμα δημιουργεί μια έκδοση με κωδικοποίηση URI για αυτήν τη συμβολοσειρά:

encodeUriComponent('https://contoso.com')

Και επιστρέφει αυτό το αποτέλεσμα: "http%3A%2F%2Fcontoso.com"

empty

Ελέγξτε εάν μια συλλογή είναι κενή. Επιστρέφει την τιμή true όταν η συλλογή είναι κενή ή επιστρέφει "false" όταν δεν είναι κενή.

empty('<collection>')
empty([<collection>])

Παράμετρος	Απαραίτητο	Type	Description
<Συλλογή>	Όχι	Συμβολοσειρά, Πίνακας ή Αντικείμενο	Η συλλογή που θα ελέγξετε

Επιστρεφόμενη αξία	Τύπος	Description
true ή false	Boolean	Επιστρέφει την τιμή true όταν η συλλογή είναι κενή. Επιστρέφει "false" όταν δεν είναι κενή.

Παράδειγμα

Αυτά τα παραδείγματα ελέγχουν εάν οι καθορισμένες συλλογές είναι κενές:

empty('')
empty('abc')

Και επιστρέφει αυτά τα αποτελέσματα:

• Πρώτο παράδειγμα: Διαβιβάζει μια κενή συμβολοσειρά, έτσι η συνάρτηση επιστρέφει true.
• Δεύτερο παράδειγμα: Διαβιβάζει τη συμβολοσειρά "abc", έτσι η συνάρτηση επιστρέφει false.

λήγειμε

Ελέγξτε εάν μια συμβολοσειρά τελειώνει με μια συγκεκριμένη δευτερεύουσα συμβολοσειρά. Επιστρέφει την τιμή true όταν βρεθεί η δευτερεύουσα συμβολοσειρά ή επιστρέφει "false" όταν δεν βρεθεί. Αυτή η συνάρτηση δεν κάνει διάκριση πεζών-κεφαλαίων.

endsWith('<text>', '<searchText>')

Παράμετρος	Απαραίτητο	Type	Περιγραφή
<Κείμενο>	Ναι	Συμβολοσειρά	Η συμβολοσειρά που θα ελεγχθεί
<searchText>	Ναι	Συμβολοσειρά	Η δευτερεύουσα συμβολοσειρά λήξης για εύρεση

Επιστρεφόμενη αξία	Τύπος	Description
true ή false	Boolean	Επιστρέφει την τιμή true όταν βρεθεί η δευτερεύουσα συμβολοσειρά λήξης. Επιστρέψτε false όταν δεν βρεθεί.

Παράδειγμα 1

Αυτό το παράδειγμα ελέγχει εάν η συμβολοσειρά "hello world" τελειώνει με τη συμβολοσειρά "world":

endsWith('hello world', 'world')

Και επιστρέφει αυτό το αποτέλεσμα: true

Παράδειγμα 2

Αυτό το παράδειγμα ελέγχει εάν η συμβολοσειρά "hello world" τελειώνει με τη συμβολοσειρά "σύμπαν":

endsWith('hello world', 'universe')

Και επιστρέφει αυτό το αποτέλεσμα: false

ισούται

Ελέγξτε εάν αμφότερες οι τιμές, παραστάσεις ή αντικείμενα είναι ισοδύναμα. Επιστρέφει την τιμή true όταν και οι δύο είναι ισοδύναμες ή επιστρέφει "false" όταν δεν είναι ισοδύναμες.

equals('<object1>', '<object2>')

Παράμετρος	Απαραίτητο	Type	Description
<object1>, <object2>	Όχι	Διάφορα	Οι τιμές, οι παραστάσεις ή τα αντικείμενα προς σύγκριση

Επιστρεφόμενη αξία	Τύπος	Description
true ή false	Boolean	Επιστρέφει την τιμή true όταν και οι δύο είναι ισοδύναμες. Επιστρέφει "false" όταν δεν είναι ισοδύναμο.

Παράδειγμα

Αυτά τα παραδείγματα ελέγχουν εάν οι καθορισμένες εισόδους είναι ισοδύναμες.

equals(true, 1)
equals('abc', 'abcd')

Και επιστρέφει αυτά τα αποτελέσματα:

• Πρώτο παράδειγμα: Και οι δύο τιμές είναι ισοδύναμες, επομένως η συνάρτηση επιστρέφει true.
• Δεύτερο παράδειγμα: Και οι δύο τιμές δεν είναι ισοδύναμες, επομένως η συνάρτηση επιστρέφει false.

Πρώτη

Επιστρέψτε το πρώτο στοιχείο από μια συμβολοσειρά ή πίνακα.

first('<collection>')
first([<collection>])

Παράμετρος	Απαραίτητο	Type	Description
<Συλλογή>	Όχι	Συμβολοσειρά ή πίνακας	Η συλλογή όπου θα βρείτε το πρώτο στοιχείο

Επιστρεφόμενη αξία	Τύπος	Description
<στοιχείο-πρώτης συλλογής>	Any	Το πρώτο στοιχείο στη συλλογή

Παράδειγμα

Αυτά τα παραδείγματα βρίσκουν το πρώτο στοιχείο σε αυτές τις συλλογές:

first('hello')
first(createArray(0, 1, 2))

Και επιστρέψτε αυτά τα αποτελέσματα:

• Πρώτο παράδειγμα: "h"
• Δεύτερο παράδειγμα: 0

κινητή υποδιαστολή

Μετατρέψτε μια έκδοση συμβολοσειράς για έναν αριθμό κινητής υποδιαστολής σε πραγματικό αριθμό κινητής υποδιαστολής.

float('<value>')

Παράμετρος	Απαραίτητο	Type	Description
<Τιμή>	Ναι	Συμβολοσειρά	Η συμβολοσειρά που διαθέτει έναν έγκυρο αριθμό κινητής υποδιαστολής για μετατροπή

Επιστρεφόμενη αξία	Τύπος	Description
<τιμή κινητής υποδιαστολής>	Επιπλέουν	Ο αριθμός κινητής υποδιαστολής για την καθορισμένη συμβολοσειρά

Παράδειγμα

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

float('10.333')

Και επιστρέφει αυτό το αποτέλεσμα: 10.333

formatDateTime

Επιστρέφει μια χρονική σήμανση στην καθορισμένη μορφή.

formatDateTime('<timestamp>', '<format>'?)

Παράμετρος	Απαραίτητο	Type	Description
<Χρονική σήμανση>	Ναι	Συμβολοσειρά	Η συμβολοσειρά που περιέχει τη χρονική σήμανση
<Μορφή>	Όχι	Συμβολοσειρά	Είτε ένα προσδιοριστικό μοναδικής μορφής είτε ένα προσαρμοσμένο μοτίβο μορφής. Η προεπιλεγμένη μορφή για τη χρονική σήμανση είναι "o" (εεεε-ΜΜ-ddTHH:mm:ss.fffffffK), η οποία συμμορφώνεται με το ISO 8601 και διατηρεί τις πληροφορίες ζώνης ώρας.

Επιστρεφόμενη αξία	Τύπος	Description
<αναδιαμορφώθηκε-χρονική σήμανση>	Συμβολοσειρά	Η ενημερωμένη χρονική σήμανση στην καθορισμένη μορφή

Παράδειγμα

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

formatDateTime('03/15/2018 12:00:00', 'yyyy-MM-ddTHH:mm:ss')

Και επιστρέφει αυτό το αποτέλεσμα: "2018-03-15T12:00:00"

getFutureTime

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

getFutureTime(<interval>, <timeUnit>, <format>?)

Παράμετρος	Απαραίτητο	Type	Description
<Διάστημα>	Όχι	Integer	Ο αριθμός καθορισμένων μονάδων ώρας που θα προστεθούν
<timeUnit>	Ναι	Συμβολοσειρά	Η μονάδα χρόνου που θα χρησιμοποιηθεί με το διάστημα: "Second", "Minute", "Hour", "Day", "Week", "Month", "Year"
<Μορφή>	Όχι	Συμβολοσειρά	Είτε ένα προσδιοριστικό μοναδικής μορφής είτε ένα προσαρμοσμένο μοτίβο μορφής. Η προεπιλεγμένη μορφή για τη χρονική σήμανση είναι "o" (εεεε-ΜΜ-ddTHH:mm:ss.fffffffK), η οποία συμμορφώνεται με το ISO 8601 και διατηρεί τις πληροφορίες ζώνης ώρας.

Επιστρεφόμενη αξία	Τύπος	Description
<ενημερωμένη χρονική σήμανση>	Συμβολοσειρά	Η τρέχουσα χρονική σήμανση συν τον καθορισμένο αριθμό μονάδων ώρας

Παράδειγμα 1

Ας υποθέσουμε ότι η τρέχουσα χρονική σήμανση είναι "2018-03-01T00:00:00.000000Z". Αυτό το παράδειγμα προσθέτει πέντε ημέρες στη συγκεκριμένη χρονική σήμανση:

getFutureTime(5, 'Day')

Και επιστρέφει αυτό το αποτέλεσμα: "2018-03-06T00:00:00.0000000Z"

Παράδειγμα 2

Ας υποθέσουμε ότι η τρέχουσα χρονική σήμανση είναι "2018-03-01T00:00:00.000000Z". Αυτό το παράδειγμα προσθέτει πέντε ημέρες και μετατρέπει το αποτέλεσμα σε μορφή "D":

getFutureTime(5, 'Day', 'D')

Και επιστρέφει αυτό το αποτέλεσμα: "Tuesday, March 6, 2018"

getPastTime

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

getPastTime(<interval>, <timeUnit>, <format>?)

Παράμετρος	Απαραίτητο	Type	Description
<Διάστημα>	Όχι	Integer	Ο αριθμός καθορισμένων χρονικών μονάδων που θα αφαιρεθούν
<timeUnit>	Ναι	Συμβολοσειρά	Η μονάδα χρόνου που θα χρησιμοποιηθεί με το διάστημα: "Second", "Minute", "Hour", "Day", "Week", "Month", "Year"
<Μορφή>	Όχι	Συμβολοσειρά	Είτε ένα προσδιοριστικό μοναδικής μορφής είτε ένα προσαρμοσμένο μοτίβο μορφής. Η προεπιλεγμένη μορφή για τη χρονική σήμανση είναι "o" (εεεε-ΜΜ-ddTHH:mm:ss.fffffffK), η οποία συμμορφώνεται με το ISO 8601 και διατηρεί τις πληροφορίες ζώνης ώρας.

Επιστρεφόμενη αξία	Τύπος	Description
<ενημερωμένη χρονική σήμανση>	Συμβολοσειρά	Η τρέχουσα χρονική σήμανση μείον τον καθορισμένο αριθμό μονάδων ώρας

Παράδειγμα 1

Ας υποθέσουμε ότι η τρέχουσα χρονική σήμανση είναι "2018-02-01T00:00:00.000000Z". Αυτό το παράδειγμα αφαιρεί πέντε ημέρες από τη συγκεκριμένη χρονική σήμανση:

getPastTime(5, 'Day')

Και επιστρέφει αυτό το αποτέλεσμα: "2018-01-27T00:00:00.0000000Z"

Παράδειγμα 2

Ας υποθέσουμε ότι η τρέχουσα χρονική σήμανση είναι "2018-02-01T00:00:00.000000Z". Αυτό το παράδειγμα αφαιρεί πέντε ημέρες και μετατρέπει το αποτέλεσμα σε μορφή "D":

getPastTime(5, 'Day', 'D')

Και επιστρέφει αυτό το αποτέλεσμα: "Saturday, January 27, 2018"

greater

Ελέγξτε εάν η πρώτη τιμή είναι μεγαλύτερη από τη δεύτερη τιμή. Επιστρέφει την τιμή true όταν η πρώτη τιμή είναι μεγαλύτερη ή επιστρέφει "false" όταν είναι μικρότερη.

greater(<value>, <compareTo>)
greater('<value>', '<compareTo>')

Παράμετρος	Απαραίτητο	Type	Description
<Τιμή>	Όχι	Ακέραιος αριθμός, κινητή υποδιαστολή ή Συμβολοσειρά	Η πρώτη τιμή που θα ελεγχθεί εάν είναι μεγαλύτερη από τη δεύτερη τιμή
<compareTo>	Όχι	Ακέραιος αριθμός, Κινητή υποδιαστολή ή Συμβολοσειρά, αντίστοιχα	Η τιμή σύγκρισης

Επιστρεφόμενη αξία	Τύπος	Description
true ή false	Boolean	Επιστρέφει την τιμή true όταν η πρώτη τιμή είναι μεγαλύτερη από τη δεύτερη τιμή. Επιστρέφει false όταν η πρώτη τιμή ισούται με ή μικρότερη από τη δεύτερη τιμή.

Παράδειγμα

Αυτά τα παραδείγματα ελέγχουν εάν η πρώτη τιμή είναι μεγαλύτερη από τη δεύτερη τιμή:

greater(10, 5)
greater('apple', 'banana')

Και επιστρέψτε αυτά τα αποτελέσματα:

• Πρώτο παράδειγμα: true
• Δεύτερο παράδειγμα: false

greaterOrEquals

Ελέγξτε εάν η πρώτη τιμή είναι μεγαλύτερη ή ίση με τη δεύτερη τιμή. Επιστρέφει την τιμή true όταν η πρώτη τιμή είναι μεγαλύτερη ή ίση ή επιστρέφει "false" όταν η πρώτη τιμή είναι μικρότερη.

greaterOrEquals(<value>, <compareTo>)
greaterOrEquals('<value>', '<compareTo>')

Παράμετρος	Απαραίτητο	Type	Description
<Τιμή>	Όχι	Ακέραιος αριθμός, κινητή υποδιαστολή ή Συμβολοσειρά	Η πρώτη τιμή που ελέγχει αν είναι μεγαλύτερη ή ίση από τη δεύτερη τιμή
<compareTo>	Όχι	Ακέραιος αριθμός, Κινητή υποδιαστολή ή Συμβολοσειρά, αντίστοιχα	Η τιμή σύγκρισης

Επιστρεφόμενη αξία	Τύπος	Description
true ή false	Boolean	Επιστρέφει την τιμή true όταν η πρώτη τιμή είναι μεγαλύτερη ή ίση από τη δεύτερη τιμή. Επιστρέφει "false" όταν η πρώτη τιμή είναι μικρότερη της δεύτερης τιμής.

Παράδειγμα

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

greaterOrEquals(5, 5)
greaterOrEquals('apple', 'banana')

Και επιστρέψτε αυτά τα αποτελέσματα:

• Πρώτο παράδειγμα: true
• Δεύτερο παράδειγμα: false

Guid

Δημιουργήστε ένα καθολικά μοναδικό αναγνωριστικό (GUID) ως συμβολοσειρά, για παράδειγμα, "c2ecc88d-88c8-4096-912c-d6f2e2b138ce":

guid()

Επίσης, μπορείτε να καθορίσετε μια διαφορετική μορφή για το GUID εκτός από την προεπιλεγμένη μορφή "D", η οποία είναι 32 ψηφία διαχωρισμένα με ενωτικά.

guid('<format>')

Παράμετρος	Απαραίτητο	Type	Description
<Μορφή>	Όχι	Συμβολοσειρά	Ένα προσδιοριστικό μοναδικής μορφής για το GUID που επιστρέφεται. Από προεπιλογή, η μορφή είναι "D", αλλά μπορείτε να χρησιμοποιήσετε τα στοιχεία "N", "D", "B", "P" ή "X".

Επιστρεφόμενη αξία	Τύπος	Description
<Τιμή GUID>	Συμβολοσειρά	Ένα τυχαία δημιουργημένο GUID

Παράδειγμα

Αυτό το παράδειγμα δημιουργεί το ίδιο GUID, αλλά ως 32 ψηφία, διαχωρισμένα με ενωτικά και περικλείονται σε παρενθέσεις:

guid('P')

Και επιστρέφει αυτό το αποτέλεσμα: "(c2ecc88d-88c8-4096-912c-d6f2e2b138ce)"

εάν

Ελέγξτε εάν μια παράσταση είναι true ή false. Με βάση το αποτέλεσμα, επιστρέψτε μια καθορισμένη τιμή.

if(<expression>, <valueIfTrue>, <valueIfFalse>)

Παράμετρος	Απαραίτητο	Type	Description
<Έκφραση>	Όχι	Boolean	Η παράσταση προς έλεγχο
<valueIfTrue>	Όχι	Any	Η τιμή που επιστρέφεται όταν η παράσταση είναι true
<valueIfFalse>	Όχι	Any	Η τιμή που επιστρέφεται όταν η παράσταση είναι false

Επιστρεφόμενη αξία	Τύπος	Description
<καθορισμένη-τιμή-επιστροφής>	Any	Η καθορισμένη τιμή που επιστρέφει με βάση εάν η παράσταση είναι true ή false

Παράδειγμα

Αυτό το παράδειγμα επιστρέφει "yes" επειδή η καθορισμένη παράσταση επιστρέφει true. Διαφορετικά, το παράδειγμα επιστρέφει "no":

if(equals(1, 1), 'yes', 'no')

indexOf

Επιστρέφει τη θέση εκκίνησης ή την τιμή ευρετηρίου για μια δευτερεύουσα συμβολοσειρά. Αυτή η συνάρτηση δεν κάνει διάκριση πεζών-κεφαλαίων και τα ευρετήρια ξεκινούν με τον αριθμό 0.

indexOf('<text>', '<searchText>')

Παράμετρος	Απαραίτητο	Type	Περιγραφή
<Κείμενο>	Ναι	Συμβολοσειρά	Η συμβολοσειρά που περιέχει τη δευτερεύουσα συμβολοσειρά για εύρεση
<searchText>	Ναι	Συμβολοσειρά	Η δευτερεύουσα συμβολοσειρά που θα βρεθεί

Επιστρεφόμενη αξία	Τύπος	Description
<τιμή-ευρετηρίου>	Integer	Η θέση εκκίνησης ή η τιμή ευρετηρίου για την καθορισμένη δευτερεύουσα συμβολοσειρά. Εάν η συμβολοσειρά δεν βρεθεί, επιστρέψτε τον αριθμό -1.

Παράδειγμα

Αυτό το παράδειγμα εντοπίζει την τιμή ευρετηρίου εκκίνησης για τη δευτερεύουσα συμβολοσειρά "world" στη συμβολοσειρά "hello world":

indexOf('hello world', 'world')

Και επιστρέφει αυτό το αποτέλεσμα: 6

ακέραιος

Επιστρέψτε την έκδοση ακέραιου για μια συμβολοσειρά.

int('<value>')

Παράμετρος	Απαραίτητο	Type	Description
<Τιμή>	Ναι	Συμβολοσειρά	Η συμβολοσειρά προς μετατροπή

Επιστρεφόμενη αξία	Τύπος	Description
<ακέραιο-αποτέλεσμα>	Integer	Η έκδοση ακέραιου για την καθορισμένη συμβολοσειρά

Παράδειγμα

Αυτό το παράδειγμα δημιουργεί μια ακέραια έκδοση για τη συμβολοσειρά "10":

int('10')

Και επιστρέφει αυτό το αποτέλεσμα: 10

json

Επιστρέφει την τιμή ή το αντικείμενο του τύπου Σημειογραφία αντικειμένου JavaScript (JSON) για μια συμβολοσειρά ή XML.

json('<value>')

Παράμετρος	Απαραίτητο	Type	Description
<Τιμή>	Όχι	Συμβολοσειρά ή XML	Η συμβολοσειρά ή XML προς μετατροπή

Επιστρεφόμενη αξία	Τύπος	Description
<Αποτέλεσμα JSON>	Εγγενής τύπος ή αντικείμενο JSON	Η τιμή εγγενούς τύπου JSON ή αντικείμενο για την καθορισμένη συμβολοσειρά ή XML. Εάν η συμβολοσειρά είναι null, η συνάρτηση επιστρέφει ένα κενό αντικείμενο.

Παράδειγμα 1

Αυτό το παράδειγμα μετατρέπει αυτήν τη συμβολοσειρά στην τιμή JSON:

json('[1, 2, 3]')

Και επιστρέφει αυτό το αποτέλεσμα: [1, 2, 3]

Παράδειγμα 2

Αυτό το παράδειγμα μετατρέπει αυτήν τη συμβολοσειρά σε JSON:

json('{"fullName": "Sophia Owen"}')

Και επιστρέφει αυτό το αποτέλεσμα:

{
  "fullName": "Sophia Owen"
}

Παράδειγμα 3

Αυτό το παράδειγμα μετατρέπει αυτή την XML σε JSON:

json(xml('<?xml version="1.0"?> <root> <person id='1'> <name>Sophia Owen</name> <occupation>Engineer</occupation> </person> </root>'))

Και επιστρέφει αυτό το αποτέλεσμα:

{
   "?xml": { "@version": "1.0" },
   "root": {
      "person": [ {
         "@id": "1",
         "name": "Sophia Owen",
         "occupation": "Engineer"
      } ]
   }
}

Διασταύρωση

Επιστρέφει μια συλλογή που διαθέτει μόνο τα κοινά στοιχεία σε όλες τις καθορισμένες συλλογές. Για να εμφανιστεί στο αποτέλεσμα, πρέπει να εμφανίζεται ένα στοιχείο σε όλες τις συλλογές που μεταβιβάζονται σε αυτήν τη συνάρτηση. Εάν ένα ή περισσότερα στοιχεία έχουν το ίδιο όνομα, το τελευταίο στοιχείο με αυτό το όνομα εμφανίζεται στο αποτέλεσμα.

intersection([<collection1>], [<collection2>], ...)
intersection('<collection1>', '<collection2>', ...)

Παράμετρος	Απαραίτητο	Type	Description
<collection1>, <collection2>, ...	Όχι	Πίνακας ή αντικείμενο, αλλά όχι και τα δύο	Οι συλλογές από όπου θέλετε μόνο τα συνήθη στοιχεία

Επιστρεφόμενη αξία	Τύπος	Description
<κοινά στοιχεία>	Πίνακας ή Αντικείμενο, αντίστοιχα	Μια συλλογή που διαθέτει μόνο συνήθη στοιχεία σε όλες τις καθορισμένες συλλογές

Παράδειγμα

Αυτό το παράδειγμα εντοπίζει τα συνήθη στοιχεία σε αυτούς τους πίνακες:

intersection(createArray(1, 2, 3), createArray(101, 2, 1, 10), createArray(6, 8, 1, 2))

Και επιστρέφει έναν πίνακα μόνο με αυτά τα στοιχεία:[1, 2]

join

Επιστρέφει μια συμβολοσειρά που περιέχει όλα τα στοιχεία από έναν πίνακα και διαθέτει κάθε χαρακτήρα που διαχωρίζεται με έναν οριοθέτη.

join([<collection>], '<delimiter>')

Παράμετρος	Απαραίτητο	Type	Description
<Συλλογή>	Όχι	Πίνακας	Ο πίνακας που περιέχει τα στοιχεία για σύνδεση
<Οριοθέτης>	Ναι	Συμβολοσειρά	Το διαχωριστικό που εμφανίζεται μεταξύ κάθε χαρακτήρα στη συμβολοσειρά που προκύπτει

Επιστρεφόμενη αξία	Τύπος	Description
<οριοθέτης><char2>>< char1...><	Συμβολοσειρά	Η συμβολοσειρά που προκύπτει δημιουργήθηκε από όλα τα στοιχεία στον καθορισμένο πίνακα

Παράδειγμα

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

join(createArray('a', 'b', 'c'), '.')

Και επιστρέφει αυτό το αποτέλεσμα: "a.b.c"

Τελευταία

Επιστρέψτε το τελευταίο στοιχείο από μια συλλογή.

last('<collection>')
last([<collection>])

Παράμετρος	Απαραίτητο	Type	Description
<Συλλογή>	Όχι	Συμβολοσειρά ή πίνακας	Η συλλογή όπου θα βρείτε το τελευταίο στοιχείο

Επιστρεφόμενη αξία	Τύπος	Description
<τελευταίο στοιχείο-συλλογής>	Συμβολοσειρά ή πίνακας, αντίστοιχα	Το τελευταίο στοιχείο στη συλλογή

Παράδειγμα

Αυτά τα παραδείγματα βρίσκουν το τελευταίο στοιχείο σε αυτές τις συλλογές:

last('abcd')
last(createArray(0, 1, 2, 3))

Και επιστρέφει αυτά τα αποτελέσματα:

• Πρώτο παράδειγμα: "d"
• Δεύτερο παράδειγμα: 3

lastIndexOf

Επιστρέφει τη θέση εκκίνησης ή την τιμή ευρετηρίου για την τελευταία εμφάνιση μιας δευτερεύουσας συμβολοσειράς. Αυτή η συνάρτηση δεν κάνει διάκριση πεζών-κεφαλαίων και τα ευρετήρια ξεκινούν με τον αριθμό 0.

lastIndexOf('<text>', '<searchText>')

Παράμετρος	Απαραίτητο	Type	Περιγραφή
<Κείμενο>	Ναι	Συμβολοσειρά	Η συμβολοσειρά που περιέχει τη δευτερεύουσα συμβολοσειρά για εύρεση
<searchText>	Ναι	Συμβολοσειρά	Η δευτερεύουσα συμβολοσειρά που θα βρεθεί

Επιστρεφόμενη αξία	Τύπος	Description
<τιμή-δείκτη λήξης>	Integer	Η θέση εκκίνησης ή η τιμή ευρετηρίου για την τελευταία εμφάνιση της καθορισμένης δευτερεύουσας συμβολοσειράς. Εάν η συμβολοσειρά δεν βρεθεί, επιστρέψτε τον αριθμό -1.

Παράδειγμα

Αυτό το παράδειγμα βρίσκει την τιμή ευρετηρίου εκκίνησης για την τελευταία εμφάνιση της δευτερεύουσας συμβολοσειράς "world" στη συμβολοσειρά "hello world":

lastIndexOf('hello world', 'world')

Και επιστρέφει αυτό το αποτέλεσμα: 6

διάρκεια

Επιστρέφει τον αριθμό των στοιχείων σε μια συλλογή.

length('<collection>')
length([<collection>])

Παράμετρος	Απαραίτητο	Type	Description
<Συλλογή>	Όχι	Συμβολοσειρά ή πίνακας	Η συλλογή με τα στοιχεία προς μέτρηση

Επιστρεφόμενη αξία	Τύπος	Description
<μήκος ή πλήθος>	Integer	Ο αριθμός των στοιχείων στη συλλογή

Παράδειγμα

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

length('abcd')
length(createArray(0, 1, 2, 3))

Και επιστρέψτε αυτό το αποτέλεσμα: 4

less

Ελέγξτε εάν η πρώτη τιμή είναι μικρότερη από τη δεύτερη τιμή. Επιστρέφει την τιμή true όταν η πρώτη τιμή είναι μικρότερη ή επιστρέφει "false" όταν η πρώτη τιμή είναι μεγαλύτερη.

less(<value>, <compareTo>)
less('<value>', '<compareTo>')

Παράμετρος	Απαραίτητο	Type	Description
<Τιμή>	Όχι	Ακέραιος αριθμός, κινητή υποδιαστολή ή Συμβολοσειρά	Η πρώτη τιμή που θα ελέγξετε εάν είναι μικρότερη από τη δεύτερη τιμή
<compareTo>	Όχι	Ακέραιος αριθμός, Κινητή υποδιαστολή ή Συμβολοσειρά, αντίστοιχα	Το στοιχείο σύγκρισης

Επιστρεφόμενη αξία	Τύπος	Description
true ή false	Boolean	Επιστρέφει την τιμή true όταν η πρώτη τιμή είναι μικρότερη από τη δεύτερη τιμή. Επιστρέφει "false" όταν η πρώτη τιμή ισούται με ή είναι μεγαλύτερη από τη δεύτερη τιμή.

Παράδειγμα

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

less(5, 10)
less('banana', 'apple')

Και επιστρέψτε αυτά τα αποτελέσματα:

• Πρώτο παράδειγμα: true
• Δεύτερο παράδειγμα: false

lessOrEquals

Ελέγξτε εάν η πρώτη τιμή είναι μικρότερη ή ίση από τη δεύτερη τιμή. Επιστρέφει "true" όταν η πρώτη τιμή είναι μικρότερη ή ίση ή επιστρέφει "false" όταν η πρώτη τιμή είναι μεγαλύτερη.

lessOrEquals(<value>, <compareTo>)
lessOrEquals('<value>', '<compareTo>')

Παράμετρος	Απαραίτητο	Type	Description
<Τιμή>	Όχι	Ακέραιος αριθμός, κινητή υποδιαστολή ή Συμβολοσειρά	Η πρώτη τιμή που θα ελέγξετε αν είναι μικρότερη ή ίση από τη δεύτερη τιμή
<compareTo>	Όχι	Ακέραιος αριθμός, Κινητή υποδιαστολή ή Συμβολοσειρά, αντίστοιχα	Το στοιχείο σύγκρισης

Επιστρεφόμενη αξία	Τύπος	Description
true ή false	Boolean	Επιστρέφει την τιμή true όταν η πρώτη τιμή είναι μικρότερη ή ίση από τη δεύτερη τιμή. Επιστρέφει "false" όταν η πρώτη τιμή είναι μεγαλύτερη από τη δεύτερη τιμή.

Παράδειγμα

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

lessOrEquals(10, 10)
lessOrEquals('apply', 'apple')

Και επιστρέψτε αυτά τα αποτελέσματα:

• Πρώτο παράδειγμα: true
• Δεύτερο παράδειγμα: false

Μέγιστο

Επιστρέφει την υψηλότερη τιμή από μια λίστα ή πίνακα με αριθμούς που περιλαμβάνονται και στα δύο άκρα.

max(<number1>, <number2>, ...)
max([<number1>, <number2>, ...])

Παράμετρος	Απαραίτητο	Type	Description
<number1>, <number2>, ...	Όχι	Ακέραιος αριθμός, κινητή υποδιαστολή ή και τα δύο	Το σύνολο αριθμών από το οποίο θέλετε την υψηλότερη τιμή
[<number1>, <number2>, ...]	Όχι	Πίνακας - Ακέραιος, κινητή υποδιαστολή ή και τα δύο	Ο πίνακας αριθμών από τον οποίο θέλετε την υψηλότερη τιμή

Επιστρεφόμενη αξία	Τύπος	Description
<μέγιστη τιμή>	Ακέραιος ή κινητή υποδιαστολή	Η υψηλότερη τιμή στον καθορισμένο πίνακα ή σύνολο αριθμών

Παράδειγμα

Αυτά τα παραδείγματα λαμβάνουν την υψηλότερη τιμή από το σύνολο αριθμών και τον πίνακα:

max(1, 2, 3)
max(createArray(1, 2, 3))

Και επιστρέψτε αυτό το αποτέλεσμα: 3

λεπτά

Επιστρέφει τη χαμηλότερη τιμή από ένα σύνολο αριθμών ή έναν πίνακα.

min(<number1>, <number2>, ...)
min([<number1>, <number2>, ...])

Παράμετρος	Απαραίτητο	Type	Description
<number1>, <number2>, ...	Όχι	Ακέραιος αριθμός, κινητή υποδιαστολή ή και τα δύο	Το σύνολο αριθμών από το οποίο θέλετε τη χαμηλότερη τιμή
[<number1>, <number2>, ...]	Όχι	Πίνακας - Ακέραιος, κινητή υποδιαστολή ή και τα δύο	Ο πίνακας αριθμών από τον οποίο θέλετε τη χαμηλότερη τιμή

Επιστρεφόμενη αξία	Τύπος	Description
<ελάχιστη τιμή>	Ακέραιος ή κινητή υποδιαστολή	Η χαμηλότερη τιμή στο καθορισμένο σύνολο αριθμών ή τον καθορισμένο πίνακα

Παράδειγμα

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

min(1, 2, 3)
min(createArray(1, 2, 3))

Και επιστρέψτε αυτό το αποτέλεσμα: 1

mod

Επιστρέφει το υπόλοιπο της διαίρεσης δύο αριθμών. Για να λάβετε το αποτέλεσμα ακέραιου, ανατρέξτε στο θέμα div().

mod(<dividend>, <divisor>)

Παράμετρος	Απαραίτητο	Type	Description
<Μέρισμα>	Όχι	Ακέραιος ή κινητή υποδιαστολή	Ο αριθμός προς διαίρεση με τον διαιρέτη
<Διαιρέτης>	Όχι	Ακέραιος ή κινητή υποδιαστολή	Ο αριθμός που διαιρεί το μέρισμα, αλλά δεν μπορεί να είναι 0.

Επιστρεφόμενη αξία	Τύπος	Description
<αποτέλεσμα modulo>	Ακέραιος ή κινητή υποδιαστολή	Το υπόλοιπο της διαίρεσης του πρώτου αριθμού με τον δεύτερο αριθμό

Παράδειγμα

Αυτό το παράδειγμα διαιρεί τον πρώτο αριθμό με τον δεύτερο αριθμό:

mod(3, 2)

Και επιστρέψτε αυτό το αποτέλεσμα: 1

Mul

Επιστρέφει το προϊόν από τον πολλαπλασιασμό δύο αριθμών.

mul(<multiplicand1>, <multiplicand2>)

Παράμετρος	Απαραίτητο	Type	Description
<multiplicand1>	Όχι	Ακέραιος ή κινητή υποδιαστολή	Ο αριθμός για πολλαπλασιασμό με πολλαπλασιασμό2
<multiplicand2>	Όχι	Ακέραιος ή κινητή υποδιαστολή	Ο αριθμός πολλαπλών πολλαπλώνand1

Επιστρεφόμενη αξία	Τύπος	Description
<αποτέλεσμα προϊόντος>	Ακέραιος ή κινητή υποδιαστολή	Το προϊόν από τον πολλαπλασιασμό του πρώτου αριθμού με τον δεύτερο αριθμό

Παράδειγμα

Αυτά τα παραδείγματα πολλαπλασιάουν τον πρώτο αριθμό με βάση τον δεύτερο αριθμό:

mul(1, 2)
mul(1.5, 2)

Και επιστρέψτε αυτά τα αποτελέσματα:

• Πρώτο παράδειγμα: 2
• Δεύτερο παράδειγμα 3

not

Ελέγξτε εάν μια παράσταση είναι false. Επιστρέφει την τιμή true όταν η παράσταση είναι false ή επιστρέφει "false" όταν είναι true.

not(<expression>)

Παράμετρος	Απαραίτητο	Type	Description
<Έκφραση>	Όχι	Boolean	Η παράσταση προς έλεγχο

Επιστρεφόμενη αξία	Τύπος	Description
true ή false	Boolean	Επιστρέφει την τιμή true όταν η παράσταση είναι false. Επιστρέφει false όταν η παράσταση είναι true.

Παράδειγμα 1

Αυτά τα παραδείγματα ελέγχουν εάν οι καθορισμένες παραστάσεις είναι false:

not(false)
not(true)

Και επιστρέψτε αυτά τα αποτελέσματα:

• Πρώτο παράδειγμα: Η παράσταση είναι false, επομένως η συνάρτηση επιστρέφει true.
• Δεύτερο παράδειγμα: Η παράσταση είναι true, επομένως η συνάρτηση επιστρέφει false.

Παράδειγμα 2

Αυτά τα παραδείγματα ελέγχουν εάν οι καθορισμένες παραστάσεις είναι false:

not(equals(1, 2))
not(equals(1, 1))

Και επιστρέψτε αυτά τα αποτελέσματα:

• Πρώτο παράδειγμα: Η παράσταση είναι false, επομένως η συνάρτηση επιστρέφει true.
• Δεύτερο παράδειγμα: Η παράσταση είναι true, επομένως η συνάρτηση επιστρέφει false.

ή

Ελέγξτε εάν τουλάχιστον μία παράσταση είναι true. Επιστρέφει την τιμή true όταν τουλάχιστον μία παράσταση είναι true ή επιστρέφει "false" όταν και οι δύο είναι false.

or(<expression1>, <expression2>)

Παράμετρος	Απαραίτητο	Type	Description
<expression1>, <expression2>	Όχι	Boolean	Οι παραστάσεις για έλεγχο

Επιστρεφόμενη αξία	Τύπος	Description
true ή false	Boolean	Επιστρέφει την τιμή true όταν τουλάχιστον μία παράσταση είναι true. Επιστρέψτε false όταν και οι δύο παραστάσεις είναι false.

Παράδειγμα 1

Αυτά τα παραδείγματα ελέγχουν εάν τουλάχιστον μία παράσταση είναι αληθής:

or(true, false)
or(false, false)

Και επιστρέψτε αυτά τα αποτελέσματα:

• Πρώτο παράδειγμα: Τουλάχιστον μία παράσταση είναι true, επομένως η συνάρτηση επιστρέφει true.
• Δεύτερο παράδειγμα: Και οι δύο παραστάσεις είναι ψευδείς, επομένως η συνάρτηση επιστρέφει false.

Παράδειγμα 2

Αυτά τα παραδείγματα ελέγχουν εάν τουλάχιστον μία παράσταση είναι αληθής:

or(equals(1, 1), equals(1, 2))
or(equals(1, 2), equals(1, 3))

Και επιστρέψτε αυτά τα αποτελέσματα:

• Πρώτο παράδειγμα: Τουλάχιστον μία παράσταση είναι true, επομένως η συνάρτηση επιστρέφει true.
• Δεύτερο παράδειγμα: Και οι δύο παραστάσεις είναι ψευδείς, επομένως η συνάρτηση επιστρέφει false.

Rand

Επιστρέφει έναν τυχαίο ακέραιο από μια καθορισμένη περιοχή, η οποία συμπεριλαμβάνεται μόνο στο τέλος έναρξης.

rand(<minValue>, <maxValue>)

Παράμετρος	Απαραίτητο	Type	Description
<minValue>	Όχι	Integer	Ο χαμηλότερος ακέραιος στην περιοχή
<maxValue>	Όχι	Integer	Ο ακέραιος που ακολουθεί τον υψηλότερο ακέραιο στην περιοχή που μπορεί να επιστρέψει η συνάρτηση

Επιστρεφόμενη αξία	Τύπος	Description
<τυχαίο αποτέλεσμα>	Integer	Ο τυχαίος ακέραιος που επιστρέφεται από την καθορισμένη περιοχή

Παράδειγμα

Αυτό το παράδειγμα λαμβάνει έναν τυχαίο ακέραιο από την καθορισμένη περιοχή, με την εξαίρεση της μέγιστης τιμής:

rand(1, 5)

Και επιστρέφει έναν από αυτούς τους αριθμούς ως αποτέλεσμα: 1, 2, 3ή 4

εύρος

Επιστρέφει έναν ακέραιο πίνακα που ξεκινά από έναν καθορισμένο ακέραιο.

range(<startIndex>, <count>)

Παράμετρος	Απαραίτητο	Type	Description
<startIndex>	Όχι	Integer	Μια ακέραια τιμή που ξεκινά τον πίνακα ως το πρώτο στοιχείο
<Αρίθμηση>	Όχι	Integer	Ο αριθμός των ακέραιων στον πίνακα

Επιστρεφόμενη αξία	Τύπος	Description
[<αποτέλεσμα-περιοχής>]	Πίνακας	Ο πίνακας με ακέραιους που ξεκινούν από το καθορισμένο ευρετήριο

Παράδειγμα

Αυτό το παράδειγμα δημιουργεί έναν ακέραιο πίνακα που ξεκινά από το καθορισμένο ευρετήριο και έχει τον καθορισμένο αριθμό ακέραιων:

range(1, 4)

Και επιστρέφει αυτό το αποτέλεσμα: [1, 2, 3, 4]

αντικατάσταση

Αντικαταστήστε μια δευτερεύουσα συμβολοσειρά με την καθορισμένη συμβολοσειρά και επιστρέψτε τη συμβολοσειρά αποτελέσματος. Αυτή η συνάρτηση κάνει διάκριση πεζών-κεφαλαίων.

replace('<text>', '<oldText>', '<newText>')

Παράμετρος	Απαραίτητο	Type	Περιγραφή
<Κείμενο>	Ναι	Συμβολοσειρά	Η συμβολοσειρά που διαθέτει τη δευτερεύουσα συμβολοσειρά για αντικατάσταση
<oldText>	Ναι	Συμβολοσειρά	Η δευτερεύουσα συμβολοσειρά που θα αντικατασταθεί
<newText>	Ναι	Συμβολοσειρά	Η συμβολοσειρά αντικατάστασης

Επιστρεφόμενη αξία	Τύπος	Description
<ενημερωμένο κείμενο>	Συμβολοσειρά	Η ενημερωμένη συμβολοσειρά μετά την αντικατάσταση της δευτερεύουσας συμβολοσειράς Εάν η δευτερεύουσα συμβολοσειρά δεν βρεθεί, επιστρέψτε την αρχική συμβολοσειρά.

Παράδειγμα

Αυτό το παράδειγμα εντοπίζει τη δευτερεύουσα συμβολοσειρά "old" στην "παλιά συμβολοσειρά" και αντικαθιστά το "παλιό" με το "νέο":

replace('the old string', 'old', 'new')

Και επιστρέφει αυτό το αποτέλεσμα: "the new string"

skip

Καταργήστε στοιχεία από το μπροστινό μέρος μιας συλλογής και επιστρέψτε όλα τα άλλα στοιχεία.

skip([<collection>], <count>)

Παράμετρος	Απαραίτητο	Type	Description
<Συλλογή>	Όχι	Πίνακας	Η συλλογή της οποίας τα στοιχεία θέλετε να καταργήσετε
<Αρίθμηση>	Όχι	Integer	Θετικός ακέραιος αριθμός στοιχείων προς κατάργηση στην αρχή

Επιστρεφόμενη αξία	Τύπος	Description
[<ενημερωμένη συλλογή>]	Πίνακας	Η ενημερωμένη συλλογή μετά την κατάργηση των καθορισμένων στοιχείων

Παράδειγμα

Αυτό το παράδειγμα καταργεί ένα στοιχείο, τον αριθμό 0, από το μπροστινό μέρος του καθορισμένου πίνακα:

skip(createArray(0, 1, 2, 3), 1)

Επίσης, επιστρέφει αυτόν τον πίνακα με τα υπόλοιπα στοιχεία: [1,2,3]

διαχωρισμός

Επιστρέφει έναν πίνακα που περιέχει δευτερεύουσες συμβολοσειρές, διαχωρισμένες με κόμματα, με βάση τον καθορισμένο χαρακτήρα οριοθέτη στην αρχική συμβολοσειρά.

split('<text>', '<delimiter>')

Παράμετρος	Απαραίτητο	Type	Περιγραφή
<Κείμενο>	Ναι	Συμβολοσειρά	Η συμβολοσειρά για διαχωρισμό σε δευτερεύουσες συμβολοσειρές με βάση τον καθορισμένο οριοθέτη στην αρχική συμβολοσειρά
<Οριοθέτης>	Ναι	Συμβολοσειρά	Ο χαρακτήρας στην αρχική συμβολοσειρά που θα χρησιμοποιηθεί ως οριοθέτης

Επιστρεφόμενη αξία	Τύπος	Description
[<substring1,substring2><>,...]	Πίνακας	Ένας πίνακας που περιέχει δευτερεύουσες συμβολοσειρές από την αρχική συμβολοσειρά, διαχωρισμένες με κόμματα

Παράδειγμα

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

split('a_b_c', '_')

Η συνάρτηση And επιστρέφει αυτόν τον πίνακα ως αποτέλεσμα: ["a","b","c"]

startOfDay

Επιστρέψτε την αρχή της ημέρας για μια χρονική σήμανση.

startOfDay('<timestamp>', '<format>'?)

Παράμετρος	Απαραίτητο	Type	Description
<Χρονική σήμανση>	Ναι	Συμβολοσειρά	Η συμβολοσειρά που περιέχει τη χρονική σήμανση
<Μορφή>	Όχι	Συμβολοσειρά	Είτε ένα προσδιοριστικό μοναδικής μορφής είτε ένα προσαρμοσμένο μοτίβο μορφής. Η προεπιλεγμένη μορφή για τη χρονική σήμανση είναι "o" (εεεε-ΜΜ-ddTHH:mm:ss.fffffffK), η οποία συμμορφώνεται με το ISO 8601 και διατηρεί τις πληροφορίες ζώνης ώρας.

Επιστρεφόμενη αξία	Τύπος	Description
<ενημερωμένη χρονική σήμανση>	Συμβολοσειρά	Η καθορισμένη χρονική σήμανση, ξεκινώντας όμως από τη σήμανση μηδέν ωρών για την ημέρα

Παράδειγμα

Αυτό το παράδειγμα εντοπίζει την αρχή της ημέρας για αυτήν τη χρονική σήμανση:

startOfDay('2018-03-15T13:30:30Z')

Και επιστρέφει αυτό το αποτέλεσμα: "2018-03-15T00:00:00.0000000Z"

startOfHour

Επιστρέψτε την αρχή της ώρας για μια χρονική σήμανση.

startOfHour('<timestamp>', '<format>'?)

Παράμετρος	Απαραίτητο	Type	Description
<Χρονική σήμανση>	Ναι	Συμβολοσειρά	Η συμβολοσειρά που περιέχει τη χρονική σήμανση
<Μορφή>	Όχι	Συμβολοσειρά	Είτε ένα προσδιοριστικό μοναδικής μορφής είτε ένα προσαρμοσμένο μοτίβο μορφής. Η προεπιλεγμένη μορφή για τη χρονική σήμανση είναι "o" (εεεε-ΜΜ-ddTHH:mm:ss.fffffffK), η οποία συμμορφώνεται με το ISO 8601 και διατηρεί τις πληροφορίες ζώνης ώρας.

Επιστρεφόμενη αξία	Τύπος	Description
<ενημερωμένη χρονική σήμανση>	Συμβολοσειρά	Η καθορισμένη χρονική σήμανση, ξεκινώντας όμως από τη σήμανση μηδενικού λεπτού για την ώρα

Παράδειγμα

Αυτό το παράδειγμα εντοπίζει την αρχή της ώρας για αυτήν τη χρονική σήμανση:

startOfHour('2018-03-15T13:30:30Z')

Και επιστρέφει αυτό το αποτέλεσμα: "2018-03-15T13:00:00.0000000Z"

startOfMonth

Επιστρέψτε την αρχή του μήνα για μια χρονική σήμανση.

startOfMonth('<timestamp>', '<format>'?)

Παράμετρος	Απαραίτητο	Type	Description
<Χρονική σήμανση>	Ναι	Συμβολοσειρά	Η συμβολοσειρά που περιέχει τη χρονική σήμανση
<Μορφή>	Όχι	Συμβολοσειρά	Είτε ένα προσδιοριστικό μοναδικής μορφής είτε ένα προσαρμοσμένο μοτίβο μορφής. Η προεπιλεγμένη μορφή για τη χρονική σήμανση είναι "o" (εεεε-ΜΜ-ddTHH:mm:ss.fffffffK), η οποία συμμορφώνεται με το ISO 8601 και διατηρεί τις πληροφορίες ζώνης ώρας.

Επιστρεφόμενη αξία	Τύπος	Description
<ενημερωμένη χρονική σήμανση>	Συμβολοσειρά	Η καθορισμένη χρονική σήμανση, ξεκινώντας όμως από την πρώτη ημέρα του μήνα με τη σήμανση μηδέν ωρών

Παράδειγμα

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

startOfMonth('2018-03-15T13:30:30Z')

Και επιστρέφει αυτό το αποτέλεσμα: "2018-03-01T00:00:00.0000000Z"

startsWith

Ελέγξτε εάν μια συμβολοσειρά ξεκινά με μια συγκεκριμένη δευτερεύουσα συμβολοσειρά. Επιστρέφει την τιμή true όταν βρεθεί η δευτερεύουσα συμβολοσειρά ή επιστρέφει "false" όταν δεν βρεθεί. Αυτή η συνάρτηση δεν κάνει διάκριση πεζών-κεφαλαίων.

startsWith('<text>', '<searchText>')

Παράμετρος	Απαραίτητο	Type	Περιγραφή
<Κείμενο>	Ναι	Συμβολοσειρά	Η συμβολοσειρά που θα ελεγχθεί
<searchText>	Ναι	Συμβολοσειρά	Η αρχική συμβολοσειρά που θα βρεθεί

Επιστρεφόμενη αξία	Τύπος	Description
true ή false	Boolean	Επιστρέφει την τιμή true όταν βρεθεί η δευτερεύουσα συμβολοσειρά εκκίνησης. Επιστρέψτε false όταν δεν βρεθεί.

Παράδειγμα 1

Αυτό το παράδειγμα ελέγχει εάν η συμβολοσειρά "hello world" ξεκινά με τη δευτερεύουσα συμβολοσειρά "hello":

startsWith('hello world', 'hello')

Και επιστρέφει αυτό το αποτέλεσμα: true

Παράδειγμα 2

Αυτό το παράδειγμα ελέγχει εάν η συμβολοσειρά "hello world" ξεκινά με τη δευτερεύουσα συμβολοσειρά "χαιρετισμού":

startsWith('hello world', 'greetings')

Και επιστρέφει αυτό το αποτέλεσμα: false

συμβολοσειρά

Επιστρέψτε την έκδοση συμβολοσειράς για μια τιμή.

string(<value>)

Παράμετρος	Απαραίτητο	Type	Description
<Τιμή>	Όχι	Any	Η τιμή προς μετατροπή

Επιστρεφόμενη αξία	Τύπος	Description
<τιμή-συμβολοσειράς>	Συμβολοσειρά	Η έκδοση συμβολοσειράς για την καθορισμένη τιμή

Παράδειγμα 1

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

string(10)

Και επιστρέφει αυτό το αποτέλεσμα: "10"

Παράδειγμα 2

Αυτό το παράδειγμα δημιουργεί μια συμβολοσειρά για το καθορισμένο αντικείμενο JSON και χρησιμοποιεί τον χαρακτήρα ανάστροφης καθέτου (\) ως χαρακτήρα διαφυγής για το διπλό εισαγωγικό (").

string( { "name": "Sophie Owen" } )

Και επιστρέφει αυτό το αποτέλεσμα: "{ \\"name\\": \\"Sophie Owen\\" }"

επιμέρους

Επιστρέφει το αποτέλεσμα από την αφαίρεση του δεύτερου αριθμού από τον πρώτο αριθμό.

sub(<minuend>, <subtrahend>)

Παράμετρος	Απαραίτητο	Type	Description
<μειωμέρο>	Όχι	Ακέραιος ή κινητή υποδιαστολή	Ο αριθμός από τον οποίο θα αφαιρεθεί ο αφαιρεόμενος
<Αφαιρετέος>	Όχι	Ακέραιος ή κινητή υποδιαστολή	Ο αριθμός προς αφαίρεση από το μειωτευόμενο

Επιστρεφόμενη αξία	Τύπος	Description
<Αποτέλεσμα>	Ακέραιος ή κινητή υποδιαστολή	Το αποτέλεσμα από την αφαίρεση του δεύτερου αριθμού από τον πρώτο αριθμό

Παράδειγμα

Αυτό το παράδειγμα αφαιρεί τον δεύτερο αριθμό από τον πρώτο αριθμό:

sub(10.3, .3)

Και επιστρέφει αυτό το αποτέλεσμα: 10

δευτερεύουσα συμβολοσειρά

Επιστρέφει χαρακτήρες από μια συμβολοσειρά, ξεκινώντας από την καθορισμένη θέση ή ευρετήριο. Οι τιμές ευρετηρίου ξεκινούν με τον αριθμό 0.

substring('<text>', <startIndex>, <length>)

Παράμετρος	Απαραίτητο	Type	Περιγραφή
<Κείμενο>	Ναι	Συμβολοσειρά	Η συμβολοσειρά της οποίας τους χαρακτήρες θέλετε
<startIndex>	Όχι	Integer	Ένας θετικός αριθμός ίσος ή μεγαλύτερος από 0 που θέλετε να χρησιμοποιήσετε ως τη θέση εκκίνησης ή την τιμή ευρετηρίου
<Μήκος>	Όχι	Integer	Ένας θετικός αριθμός χαρακτήρων που θέλετε στη δευτερεύουσα συμβολοσειρά

Επιστρεφόμενη αξία	Τύπος	Description
<αποτέλεσμα δευτερεύουσας συμβολοσειράς>	Συμβολοσειρά	Μια δευτερεύουσα συμβολοσειρά με τον καθορισμένο αριθμό χαρακτήρων, ξεκινώντας από την καθορισμένη θέση ευρετηρίου στη συμβολοσειρά προέλευσης

Παράδειγμα

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

substring('hello world', 6, 5)

Και επιστρέφει αυτό το αποτέλεσμα: "world"

subtractFromTime

Αφαιρέστε έναν αριθμό μονάδων χρόνου από μια χρονική σήμανση. Δείτε επίσης getPastTime.

subtractFromTime('<timestamp>', <interval>, '<timeUnit>', '<format>'?)

Παράμετρος	Απαραίτητο	Type	Description
<Χρονική σήμανση>	Ναι	Συμβολοσειρά	Η συμβολοσειρά που περιέχει τη χρονική σήμανση
<Διάστημα>	Όχι	Integer	Ο αριθμός καθορισμένων χρονικών μονάδων που θα αφαιρεθούν
<timeUnit>	Ναι	Συμβολοσειρά	Η μονάδα χρόνου που θα χρησιμοποιηθεί με το διάστημα: "Second", "Minute", "Hour", "Day", "Week", "Month", "Year"
<Μορφή>	Όχι	Συμβολοσειρά	Είτε ένα προσδιοριστικό μοναδικής μορφής είτε ένα προσαρμοσμένο μοτίβο μορφής. Η προεπιλεγμένη μορφή για τη χρονική σήμανση είναι "o" (εεεε-ΜΜ-ddTHH:mm:ss.fffffffK), η οποία συμμορφώνεται με το ISO 8601 και διατηρεί τις πληροφορίες ζώνης ώρας.

Επιστρεφόμενη αξία	Τύπος	Description
<ενημερωμένη χρονική σήμανση>	Συμβολοσειρά	Η χρονική σήμανση μείον τον καθορισμένο αριθμό μονάδων χρόνου

Παράδειγμα 1

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

subtractFromTime('2018-01-02T00:00:00Z', 1, 'Day')

Και επιστρέφει αυτό το αποτέλεσμα: "2018-01-01T00:00:00:0000000Z"

Παράδειγμα 2

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

subtractFromTime('2018-01-02T00:00:00Z', 1, 'Day', 'D')

Και επιστρέφει αυτό το αποτέλεσμα χρησιμοποιώντας την προαιρετική μορφή "D": "Monday, January, 1, 2018"

take

Επιστρέψτε στοιχεία από το μπροστινό μέρος μιας συλλογής.

take('<collection>', <count>)
take([<collection>], <count>)

Παράμετρος	Απαραίτητο	Type	Description
<Συλλογή>	Όχι	Συμβολοσειρά ή πίνακας	Η συλλογή της οποίας τα στοιχεία θέλετε
<Αρίθμηση>	Όχι	Integer	Ένας θετικός ακέραιος για τον αριθμό των στοιχείων που θέλετε από μπροστά

Επιστρεφόμενη αξία	Τύπος	Description
<υποσύνολο ή [<υποσύνολο>]>	Συμβολοσειρά ή πίνακας, αντίστοιχα	Μια συμβολοσειρά ή πίνακας που έχει τον καθορισμένο αριθμό στοιχείων που λαμβάνονται από το μπροστινό μέρος της αρχικής συλλογής

Παράδειγμα

Αυτά τα παραδείγματα λαμβάνουν τον καθορισμένο αριθμό στοιχείων από μπροστά από αυτές τις συλλογές:

take('abcde', 3)
take(createArray(0, 1, 2, 3, 4), 3)

Και επιστρέψτε αυτά τα αποτελέσματα:

• Πρώτο παράδειγμα: "abc"
• Δεύτερο παράδειγμα: [0, 1, 2]

Κρότωνες

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

ticks('<timestamp>')

Παράμετρος	Απαραίτητο	Type	Description
<Χρονική σήμανση>	Ναι	Συμβολοσειρά	Η συμβολοσειρά για μια χρονική σήμανση

Επιστρεφόμενη αξία	Τύπος	Description
<ticks-number>	Integer	Ο αριθμός των σημάτων ρολογιού που έχουν παρέλθει από τις 12:00:00 τα μεσάνυχτα, 1 Ιανουαρίου 0001 στο γρηγοριανό ημερολόγιο από τη χρονική σήμανση εισόδου

toLower

Επιστρέφει μια συμβολοσειρά σε πεζή μορφή. Εάν ένας χαρακτήρας στη συμβολοσειρά δεν διαθέτει έκδοση πεζών, αυτός ο χαρακτήρας παραμένει αμετάβλητος στη συμβολοσειρά που επιστρέφεται.

toLower('<text>')

Παράμετρος	Απαραίτητο	Type	Περιγραφή
<Κείμενο>	Ναι	Συμβολοσειρά	Η συμβολοσειρά προς επιστροφή σε πεζή μορφή

Επιστρεφόμενη αξία	Τύπος	Description
<πεζό κείμενο>	Συμβολοσειρά	Η αρχική συμβολοσειρά σε πεζή μορφή

Παράδειγμα

Αυτό το παράδειγμα μετατρέπει αυτήν τη συμβολοσειρά σε πεζούς χαρακτήρες:

toLower('Hello World')

Και επιστρέφει αυτό το αποτέλεσμα: "hello world"

toUpper

Επιστρέφει μια συμβολοσειρά σε μορφή κεφαλαίων. Εάν ένας χαρακτήρας στη συμβολοσειρά δεν διαθέτει έκδοση κεφαλαίων, αυτός ο χαρακτήρας παραμένει αμετάβλητος στη συμβολοσειρά που επιστρέφεται.

toUpper('<text>')

Παράμετρος	Απαραίτητο	Type	Περιγραφή
<Κείμενο>	Ναι	Συμβολοσειρά	Η συμβολοσειρά προς επιστροφή σε μορφή κεφαλαίων

Επιστρεφόμενη αξία	Τύπος	Description
<κείμενο κεφαλαίων>	Συμβολοσειρά	Η αρχική συμβολοσειρά σε μορφή κεφαλαίων

Παράδειγμα

Αυτό το παράδειγμα μετατρέπει αυτήν τη συμβολοσειρά σε κεφαλαία:

toUpper('Hello World')

Και επιστρέφει αυτό το αποτέλεσμα: "HELLO WORLD"

Τελειώματα

Καταργήστε τα αρχικά και τελικά κενά διαστήματα από μια συμβολοσειρά και επιστρέψτε την ενημερωμένη συμβολοσειρά.

trim('<text>')

Παράμετρος	Απαραίτητο	Type	Περιγραφή
<Κείμενο>	Ναι	Συμβολοσειρά	Η συμβολοσειρά που διαθέτει το αρχικό και τελικό κενό διάστημα για κατάργηση

Επιστρεφόμενη αξία	Τύπος	Description
<ενημερωμένο κείμενο>	Συμβολοσειρά	Μια ενημερωμένη έκδοση για την αρχική συμβολοσειρά χωρίς αρχικό ή τελικό κενό διάστημα

Παράδειγμα

Αυτό το παράδειγμα καταργεί το αρχικό και τελικό κενό διάστημα από τη συμβολοσειρά " Hello World ":

trim(' Hello World  ')

Και επιστρέφει αυτό το αποτέλεσμα: "Hello World"

Ένωσης

Επιστρέφει μια συλλογή που περιέχει όλα τα στοιχεία από τις καθορισμένες συλλογές. Για να εμφανιστεί στο αποτέλεσμα, ένα στοιχείο μπορεί να εμφανιστεί σε οποιαδήποτε συλλογή μεταβιβαστεί σε αυτήν τη συνάρτηση. Εάν ένα ή περισσότερα στοιχεία έχουν το ίδιο όνομα, το τελευταίο στοιχείο με αυτό το όνομα εμφανίζεται στο αποτέλεσμα.

union('<collection1>', '<collection2>', ...)
union([<collection1>], [<collection2>], ...)

Παράμετρος	Απαραίτητο	Type	Description
<collection1>, <collection2>, ...	Όχι	Πίνακας ή αντικείμενο, αλλά όχι και τα δύο	Οι συλλογές από όπου θέλετε όλα τα στοιχεία

Επιστρεφόμενη αξία	Τύπος	Description
<updatedCollection>	Πίνακας ή Αντικείμενο, αντίστοιχα	Μια συλλογή με όλα τα στοιχεία από τις καθορισμένες συλλογές - χωρίς διπλότυπα

Παράδειγμα

Αυτό το παράδειγμα λαμβάνει όλα τα στοιχεία από αυτές τις συλλογές:

union(createArray(1, 2, 3), createArray(1, 2, 10, 101))

Και επιστρέφει αυτό το αποτέλεσμα: [1, 2, 3, 10, 101]

uriComponent

Επιστρέφει μια έκδοση με κωδικοποίηση ενιαίου αναγνωριστικού πόρου (URI) για μια συμβολοσειρά, αντικαθιστώντας τους μη ασφαλείς χαρακτήρες URL με χαρακτήρες διαφυγής. Χρησιμοποιήστε αυτή τη συνάρτηση αντί για encodeUriComponent(). Παρόλο που και οι δύο συναρτήσεις λειτουργούν με τον ίδιο τρόπο, uriComponent() είναι προτιμότερο.

uriComponent('<value>')

Παράμετρος	Απαραίτητο	Type	Description
<Τιμή>	Ναι	Συμβολοσειρά	Η συμβολοσειρά προς μετατροπή σε μορφή με κωδικοποίηση URI

Επιστρεφόμενη αξία	Τύπος	Description
<κωδικοποιημένο-uri>	Συμβολοσειρά	Η συμβολοσειρά με κωδικοποίηση URI με χαρακτήρες διαφυγής

Παράδειγμα

Αυτό το παράδειγμα δημιουργεί μια έκδοση με κωδικοποίηση URI για αυτήν τη συμβολοσειρά:

uriComponent('https://contoso.com')

Και επιστρέφει αυτό το αποτέλεσμα: "http%3A%2F%2Fcontoso.com"

uriComponentToBinary

Επιστρέφει τη δυαδική έκδοση για ένα ενιαίο αναγνωριστικό πόρου (URI).

uriComponentToBinary('<value>')

Παράμετρος	Απαραίτητο	Type	Description
<Τιμή>	Ναι	Συμβολοσειρά	Η συμβολοσειρά με κωδικοποίηση URI για μετατροπή

Επιστρεφόμενη αξία	Τύπος	Description
<δυαδικό-για-κωδικοποιημένο-uri>	Συμβολοσειρά	Η δυαδική έκδοση για τη συμβολοσειρά με κωδικοποίηση URI. Το δυαδικό περιεχόμενο έχει κωδικοποίηση base64 και αντιπροσωπεύεται από $contentτο .

Παράδειγμα

Αυτό το παράδειγμα δημιουργεί τη δυαδική έκδοση για αυτήν τη συμβολοσειρά με κωδικοποίηση URI:

uriComponentToBinary('http%3A%2F%2Fcontoso.com')

Και επιστρέφει αυτό το αποτέλεσμα:

"001000100110100001110100011101000111000000100101001100 11010000010010010100110010010001100010010100110010010001 10011000110110111101101110011101000110111101110011011011 110010111001100011011011110110110100100010"

uriComponentToString

Επιστρέψτε την έκδοση συμβολοσειράς για μια συμβολοσειρά ενιαίου αναγνωριστικού πόρου (URI), αποκωδικοποιώντας ουσιαστικά τη συμβολοσειρά με κωδικοποίηση URI.

uriComponentToString('<value>')

Παράμετρος	Απαραίτητο	Type	Description
<Τιμή>	Ναι	Συμβολοσειρά	Η συμβολοσειρά με κωδικοποίηση URI για αποκωδικοποίηση

Επιστρεφόμενη αξία	Τύπος	Description
<αποκωδικοποιημένο-uri>	Συμβολοσειρά	Η αποκωδικοποιημένη έκδοση για τη συμβολοσειρά με κωδικοποίηση URI

Παράδειγμα

Αυτό το παράδειγμα δημιουργεί την έκδοση αποκωδικοποιημένης συμβολοσειράς για αυτήν τη συμβολοσειρά με κωδικοποίηση URI:

uriComponentToString('http%3A%2F%2Fcontoso.com')

Και επιστρέφει αυτό το αποτέλεσμα: "https://contoso.com"

utcNow

Επιστρέψτε την τρέχουσα χρονική σήμανση.

utcNow('<format>')

Προαιρετικά, μπορείτε να καθορίσετε μια διαφορετική μορφή με την <παράμετρο μορφής> .

Παράμετρος	Απαραίτητο	Type	Description
<Μορφή>	Όχι	Συμβολοσειρά	Είτε ένα προσδιοριστικό μοναδικής μορφής είτε ένα προσαρμοσμένο μοτίβο μορφής. Η προεπιλεγμένη μορφή για τη χρονική σήμανση είναι "o" (εεεε-ΜΜ-ddTHH:mm:ss.fffffffK), η οποία συμμορφώνεται με το ISO 8601 και διατηρεί τις πληροφορίες ζώνης ώρας.

Επιστρεφόμενη αξία	Τύπος	Description
<τρέχουσα χρονική σήμανση>	Συμβολοσειρά	Η τρέχουσα ημερομηνία και ώρα

Παράδειγμα 1

Ας υποθέσουμε ότι σήμερα είναι 15 Απριλίου 2018 στις 1:00:00 μ.μ. Αυτό το παράδειγμα λαμβάνει την τρέχουσα χρονική σήμανση:

utcNow()

Και επιστρέφει αυτό το αποτέλεσμα: "2018-04-15T13:00:00.0000000Z"

Παράδειγμα 2

Ας υποθέσουμε ότι σήμερα είναι 15 Απριλίου 2018 στις 1:00:00 μ.μ. Αυτό το παράδειγμα λαμβάνει την τρέχουσα χρονική σήμανση χρησιμοποιώντας την προαιρετική μορφή "D":

utcNow('D')

Και επιστρέφει αυτό το αποτέλεσμα: "Sunday, April 15, 2018"

xml

Επιστρέφει την έκδοση XML για μια συμβολοσειρά που περιέχει ένα αντικείμενο JSON.

xml('<value>')

Παράμετρος	Απαραίτητο	Type	Description
<Τιμή>	Ναι	Συμβολοσειρά	Η συμβολοσειρά με το αντικείμενο JSON προς μετατροπή Το αντικείμενο JSON πρέπει να έχει μόνο μία ιδιότητα ρίζας, η οποία δεν μπορεί να είναι πίνακας. Χρησιμοποιήστε τον χαρακτήρα ανάστροφης κάθετο (\) ως χαρακτήρα διαφυγής για το διπλό εισαγωγικό (").

Επιστρεφόμενη αξία	Τύπος	Description
<έκδοση xml>	Object	Η κωδικοποιημένη XML για την καθορισμένη συμβολοσειρά ή αντικείμενο JSON

Παράδειγμα 1

Αυτό το παράδειγμα δημιουργεί την έκδοση XML για αυτήν τη συμβολοσειρά, η οποία περιέχει ένα αντικείμενο JSON:

xml(json('{ \"name\": \"Sophia Owen\" }'))

Και επιστρέφει αυτό το αποτέλεσμα XML:

<name>Sophia Owen</name>

Παράδειγμα 2

Ας υποθέσουμε ότι έχετε αυτό το αντικείμενο JSON:

{
  "person": {
    "name": "Sophia Owen",
    "city": "Seattle"
  }
}

Αυτό το παράδειγμα δημιουργεί XML για μια συμβολοσειρά που περιέχει αυτό το αντικείμενο JSON:

xml(json('{\"person\": {\"name\": \"Sophia Owen\", \"city\": \"Seattle\"}}'))

Και επιστρέφει αυτό το αποτέλεσμα XML:

<person>
  <name>Sophia Owen</name>
  <city>Seattle</city>
<person>

Xpath

Ελέγξτε το XML για κόμβους ή τιμές που αντιστοιχούν σε μια παράσταση XPath (γλώσσα διαδρομής XML) και επιστρέψτε τους αντίστοιχους κόμβους ή τιμές. Μια παράσταση XPath, ή απλώς "XPath", σάς βοηθά να περιηγηθείτε σε μια δομή εγγράφου XML, ώστε να μπορείτε να επιλέξετε κόμβους ή να υπολογίσετε τιμές στο περιεχόμενο XML.

xpath('<xml>', '<xpath>')

Παράμετρος	Απαραίτητο	Type	Description
<Xml>	Όχι	Any	Η συμβολοσειρά XML για αναζήτηση για κόμβους ή τιμές που συμφωνούν με μια τιμή παράστασης XPath
<Xpath>	Όχι	Any	Η παράσταση XPath που χρησιμοποιείται για την εύρεση αντίστοιχων κόδων XML ή τιμών

Επιστρεφόμενη αξία	Τύπος	Description
<xml-node>	Xml	Ένας κόμβος XML όταν μόνο ένας κόμβος συμφωνεί με την καθορισμένη παράσταση XPath
<Τιμή>	Any	Η τιμή από έναν κόμβο XML όταν μόνο μία τιμή συμφωνεί με την καθορισμένη παράσταση XPath
[<xml-node1>, <xml-node2>, ...] -or- [<value1>, <value2>, ...]	Πίνακας	Ένας πίνακας με κόμβους XML ή τιμές που συμφωνούν με την καθορισμένη παράσταση XPath

Παράδειγμα 1

Παρακάτω στο Παράδειγμα 1, αυτό το παράδειγμα εντοπίζει κόμβους που συμφωνούν με τον <count></count> κόμβο και προσθέτει αυτές τις τιμές κόμβου με τη sum() συνάρτηση:

xpath(xml(parameters('items')), 'sum(/produce/item/count)')

Και επιστρέφει αυτό το αποτέλεσμα: 30

Παράδειγμα 2

Σε αυτό το παράδειγμα, και οι δύο παραστάσεις βρίσκουν κόμβους που συμφωνούν με τον <location></location> κόμβο, στα καθορισμένα ορίσματα, οι οποίοι περιλαμβάνουν XML με χώρο ονομάτων. Οι παραστάσεις χρησιμοποιούν τον χαρακτήρα ανάστροφης κάθετο (\) ως χαρακτήρα διαφυγής για το διπλό εισαγωγικό (").

• Παράσταση 1

  xpath(xml(body('Http')), '/*[name()=\"file\"]/*[name()=\"location\"]')

• Expression 2

  xpath(xml(body('Http')), '/*[local-name()=\"file\" and namespace-uri()=\"http://contoso.com\"]/*[local-name()=\"location\"]')

Τα ορίσματα είναι τα εξής:

• Αυτή η XML, η οποία περιλαμβάνει τον χώρο ονομάτων του εγγράφου XML, xmlns="http://contoso.com":

  <?xml version="1.0"?> <file xmlns="http://contoso.com"> <location>Paris</location> </file>
  

• Οποιαδήποτε από τις δύο παραστάσεις XPath εδώ:

  • /*[name()=\"file\"]/*[name()=\"location\"]

  • /*[local-name()=\"file\" and namespace-uri()=\"http://contoso.com\"]/*[local-name()=\"location\"]

Ακολουθεί ο κόμβος αποτελέσματος που συμφωνεί με τον <location></location> κόμβο:

<location xmlns="https://contoso.com">Paris</location>

Παράδειγμα 3

Ακολουθώντας το Παράδειγμα 3, αυτό το παράδειγμα εντοπίζει την τιμή στον <location></location> κόμβο:

xpath(xml(body('Http')), 'string(/*[name()=\"file\"]/*[name()=\"location\"])')

Και επιστρέφει αυτό το αποτέλεσμα: "Paris"

Σημείωμα

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

Σχετικό περιεχόμενο

Για οδηγίες σχετικά με τη γενική χρήση παραμέτρων, ανατρέξτε στις Παραμέτρους για το Data Factory στο Fabric