Συνάρτηση Format

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

Σύνταξη:


Format(expression [, format As String]) As String

Παράμετροι:

expression (έκφραση): Αριθμητική έκφραση που θέλετε να μετατρέψετε σε μορφοποιημένη συμβολοσειρά.

format: Συμβολοσειρά που καθορίζει τον κωδικό μορφοποίησης για τον αριθμό. Εάν παραλειφθεί το format, η συνάρτηση Format λειτουργεί όπως η συνάρτηση LibreOffice Basic Str().

Τύπος επιστροφής:

Συμβολοσειρά κειμένου.

Κώδικες μορφοποίησης

Στην BASIC, ένας κώδικας format μπορεί να χωριστεί σε τρία τμήματα που χωρίζονται με ερωτηματικά. Το πρώτο μέρος ορίζει τη μορφή για θετικές τιμές, το δεύτερο μέρος για αρνητικές τιμές και το τρίτο μέρος για το μηδέν. Εάν καθορίσετε μόνο έναν κώδικα format, αυτός ισχύει για όλους τους αριθμούς.

Μπορείτε να ορίσετε την τοπική ρύθμιση που χρησιμοποιείται για τον έλεγχο της μορφοποίησης αριθμών, ημερομηνιών και νομισμάτων στο LibreOffice Basic στο - Γλώσσες και τοπικές ρυθμίσεις - Γενικά. Στους κωδικούς μορφής Basic, το σημείο υποδιαστολής (.) χρησιμοποιείται πάντα ως δεσμευτικό θέσης για το δεκαδικό διαχωριστικό που ορίζεται στις τοπικές ρυθμίσεις σας και θα αντικατασταθεί από τον αντίστοιχο χαρακτήρα.

Το ίδιο ισχύει και για τις τοπικές ρυθμίσεις για την μορφή της ημερομηνίας, ώρας και νομίσματος. Ο κώδικας μορφοποίησης της Basic θα ερμηνευθεί και θα εμφανισθεί σύμφωνα με τις τοπικές ρυθμίσεις σας.

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

Κώδικας

Περιγραφή

0

Εάν η expression έχει ένα ψηφίο στη θέση του 0 στον κώδικα format, εμφανίζεται το ψηφίο, διαφορετικά εμφανίζεται ένα μηδέν.

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

Οι δεκαδικοί θέσεις στην expression στρογγυλοποιούνται σύμφωνα με τον αριθμό των μηδενικών που εμφανίζονται μετά το δεκαδικό διαχωριστικό στον κώδικα format.

#

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

Αυτό το σύμβολο λειτουργεί όπως το 0, εκτός από το ότι τα μηδενικά στην αρχή ή στο τέλος δεν εμφανίζονται εάν υπάρχουν περισσότεροι # χαρακτήρες στον κωδικό format από ψηφία στην expression. Εμφανίζονται μόνο τα σχετικά ψηφία της expression.

. (period)

Το δεκαδικό σύμβολο θέσης καθορίζει τον αριθμό των δεκαδικών ψηφίων αριστερά και δεξιά του διαχωριστικού δεκαδικών.

Εάν ο κωδικός format περιέχει μόνο # σύμβολα κράτησης θέσης στα αριστερά αυτού του συμβόλου, οι αριθμοί που είναι μικρότεροι από 1 ξεκινούν με δεκαδικό διαχωριστικό. Για να εμφανίζεται πάντα ένα μηδενικό στην αρχή με κλασματικούς αριθμούς, χρησιμοποιήστε το 0 ως σύμβολο κράτησης θέσης για το πρώτο ψηφίο στα αριστερά του δεκαδικού διαχωριστικού.

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

%

Πολλαπλασιάζει την expression (έκφραση) επί 100 και εισάγει το σύμβολο του ποσοστού (%) όπου εμφανίζεται η expression (έκφραση) στον κώδικα format.

E- E+ e- e+

Εάν ο κώδικας format περιέχει τουλάχιστον ένα ψηφίο κράτησης θέσης (0 ή #) στα δεξιά του συμβόλου E-, E+, e- ή e+, η expression μορφοποιείται σε επιστημονική ή εκθετική μορφή. Το γράμμα E ή e εισάγεται μεταξύ του αριθμού και του εκθέτη. Ο αριθμός των θέσεων δέσμευσης για τα ψηφία στα δεξιά του συμβόλου καθορίζει τον αριθμό των ψηφίων στον εκθέτη.

Αν ο εκθέτης είναι αρνητικός, εμφανίζεται ένα αρνητικό πρόσημο μπροστά από έναν εκθέτη με E-, E+, e-, e+. Αν ο εκθέτης είναι θετικός, τότε εμφανίζεται θετικό πρόσημο μόνο μπροστά από εκθέτες με E+ ή e+.

- + $ ( ) space

A plus (+), minus (-), dollar ($), space, or brackets entered directly in the format code is displayed as a literal character.

\

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

Η ανάστροφη κάθετος εμφανίζει τον επόμενο χαρακτήρα στον κώδικα format.

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

Οι χαρακτήρες μπροστά από τους οποίους θα πρέπει να υπάρχει μια ανάστροφη κάθετος στον κώδικα μορφής ώστε να εμφανίζονται ως ρητοί χαρακτήρες είναι οι χαρακτήρες ημερομηνίας και χρόνου (a, c, d, h, m, n, p, q, s, t, w, y, /, :), οι χαρακτήρες αριθμητικής μορφοποίησης (#, 0, %, E, e, κόμμα, τελεία) και οι χαρακτήρες μορφοποίησης συμβολοσειράς (@, &, <, >, !).


Προκαθορισμένες μορφές

Μπορείτε επίσης να χρησιμοποιήσετε τις ακόλουθες προκαθορισμένες μορφές αριθμών. Εκτός από τον "General Number" (Γενικό αριθμό), όλοι οι προκαθορισμένοι κώδικες μορφής επιστρέφουν τον αριθμό ως δεκαδικό αριθμό με δύο δεκαδικά ψηφία.

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

Κώδικας

Περιγραφή

"<"

Convert expression to lower case.

">"

Μετατροπή της expression (έκφρασης) σε κεφαλαία γράμματα.

"c" or "General Date"

Επιστρέφει την αριθμητική expression (έκφραση) σε σύντομη μορφή ημερομηνίας, προαιρετικά με "Ω:ΜΜ:ΔΣ ΠΜ/ΜΜ". Εάν η expression (έκφραση) είναι συμβολοσειρά, επιστρέφει τη συμβολοσειρά.

"n"

Επιστρέφει το λεπτό της αριθμητικής παράστασης, με 1 ή 2 ψηφία.

"nn"

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

"w"

Επιστρέφει την ημέρα της εβδομάδας της αριθμητικής παράστασης. Το 1 είναι η Κυριακή και το 7 είναι το Σάββατο.

"General Number"

Επιστρέφει την αριθμητική παράσταση με 12 ψηφία (0.#############).

"Currency"

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

"Fixed"

Επιστρέφει την αριθμητική παράσταση με 2 δεκαδικά ψηφία (0,00).

"Standard"

Επιστρέφει την αριθμητική παράσταση με διαχωριστικά χιλιάδων και 2 δεκαδικά ψηφία (@0,00).

"Percent"

Επιστρέφει την αριθμητική έκφραση ως ποσοστιαία τιμή (0,00%).

"Scientific"

Returns the numeric expression in scientific notation (#.00E+00).

"Yes/No"

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

"True/False"

Επιστρέφει την τιμή "True" εάν η αριθμητική έκφραση δεν είναι ίση με μηδέν, διαφορετικά επιστρέφει την τιμή "False". Οι τιμές "True" και "False" είναι σε τοπικές ρυθμίσεις.

"On/Off"

Επιστρέφει "Ενεργοποιημένο" εάν η αριθμητική έκφραση δεν είναι ίση με μηδέν, διαφορετικά επιστρέφει "Απενεργοποιημένο". Τα "Ενεργοποιημένο" και "Απενεργοποιημένο" είναι σε τοπικές ρυθμίσεις.

"Long Date" or "dddddd"

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

"Medium Date"

Επιστρέφει την αριθμητική έκφραση σε μορφή ημερομηνίας ΗΗ-ΜΜΜ-ΕΕ και εξαρτάται από τις τοπικές ρυθμίσεις.

"Short Date" or "ddddd"

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

"Long Time" or "ttttt"

Επιστρέφει την αριθμητική έκφραση σε μορφή μεγάλου χρόνου συστήματος και εξαρτάται από τις τοπικές ρυθμίσεις ("Ω:ΛΛ:ΔΔ ΠΜ/ΜΜ").

"Medium Time"

Returns the numeric expression in system medium time format, and depends on the locale (HH:MM AM/PM).

"Short Time"

Επιστρέφει την αριθμητική έκφραση σε μορφή σύντομης ώρας συστήματος και εξαρτάται από τις τοπικές ρυθμίσεις (ΩΩ:ΛΛ).


Κωδικοί σφάλματος:

5 Άκυρη κλήση διαδικασίας

Παράδειγμα:


Sub ExampleFormat
    MsgBox Format(6328.2, "##,##0.00")
    ' πάντα χρησιμοποιήστε μια τελεία ως διαχωριστικό δεκαδικών ψηφίων όταν εισάγετε αριθμούς στο πηγαίο κώδικα Basic.
    ' εμφανίζει παραδείγματος χάριν 6,328.20 στα αγγλικά, 6.328,20 στα γερμανικά.
msgbox Format("ABCDEFGHIJKLMNOPQRSTUVWXYZ1234567890", "<") ' επιστρέφει abcdefghijklmnopqrstuvwxyz1234567890, οι αριθμοί δεν επηρεάζονται.
msgbox Format("abcdefghijklmnopqrstuvwxyz1234567890", ">") ' επιστρέφει ABCDEFGHIJKLMNOPQRSTUVWXYZ1234567890, οι αριθμοί δεν επηρεάζονται.
Το msgBox Format(12345.6,"c") επιστρέφει τον αριθμό σε μορφή ημερομηνίας ως 18/10/33 2:24:00 PM στις γερμανικές γλώσσες.
msgBox Format(12345.6,"General Date") ' Ίδιο με το "c".
Το msgbox format(12345.004,"n") ' επιστρέφει 5
Το msgbox format(12345.004,"nn") ' επιστρέφει 05
msgbox format(12345.6,"w") '  επιστρέφει 4 (Τετάρτη).
msgbox format(log(123),"Γενικός Αριθμός") ' επιστρέφει 4,812184355372 στις γερμανικές τοπικές ρυθμίσεις
msgbox format(123456.7890,"Fixed") ' 123456.79
msgbox format(123456.1234,"Fixed") ' 123456.12
msgbox format(123456.7890,"Standard") '123,456.79
msgbox format(123456.1234,"Standard") '123,456.12
msgbox format(12.3456,"Percent") ' 1234.56%
msgbox format(0.123456,"Percent") '12.35%
msgbox format(123,"Yes/No") ' επιστρέφει μεταφρασμένο "Ναι"
msgbox format(0,"Yes/No") ' επιστρέφει σε τοπικές ρυθμίσεις "Όχι"
msgbox format(-1,"True/False") ' επιστρέφει σε τοπική ρύθμιση "True"
msgbox format(123,"On/Off") '  επιστρέφει σε τοπική ρύθμιση "Ενεργοποιημένο"
msgbox format(45756.73,"Long Date") ' επιστρέφει την Τετάρτη, 9 Απριλίου 2025 στην τοπική ρύθμισή σας
End Sub
Παρακαλούμε, υποστηρίξτε μας!

Παρακαλούμε, υποστηρίξτε μας!