Guida XVision

Sintassi

Descrizione

General Date

Visualizza data e/o ora corrispondenti al numero specificato

Per i numeri reali, visualizza data ed ora. Se la parte decimale è assente, viene visualizzata esclusivamente la data. Se la parte intera è assente viene visualizzata esclusivamente l’ora. Il formato di visualizzazione è definito dalle impostazioni di localizzazione del sistema.

Long Date

Visualizza la data formattata secondo le impostazioni di localizzazione del sistema relative alla data in formato esteso.

Ad esempio: martedi 14 settembre 2004

Medium Date

Visualizza la data formattata secondo le impostazioni di localizzazione del sistema relative alla data in formato intermedio. Ad esempio: 14-set-04

Short Date

Visualizza la data formattata secondo le impostazioni di localizzazione del sistema relative alla data in formato breve. Ad esempio: 14/09/2004

Long Time

Visualizza l’ora utilizzando le impostazioni di localizzazione del sistema relative al formato ora esteso; include ore, minuti, secondi. Ad esempio 15.45.23

Medium Time

Visualizza l’ora in formato 12-ore utilizzando ore, minuti e il qualificatore AM/PM. Ad esempio 03.45 PM

Short Time

Visualizza l’ora in formato 24-ore. Ad esempio 17:45.

Formato

Espressione

Risultato

Long Date

Now

venerdì 19 ottobre 2007

Short Time

Now

09.43

Carattere

Descrizione

(:)

Separatore ora. Secondo le impostazioni di localizzazione correnti, altri caratteri possono essere utilizzati come separatore. Il separatore divide ore, minuti e secondi nella formattazione. Il carattere effettivamente utilizzato come separatore è determinato dalle impostazioni di localizzazione del sistema. Nota: il carattere è da intendersi senza parentesi.

(/)

Separatore data. Secondo le impostazioni di localizzazione correnti, altri caratteri possono essere utilizzati come separatore. Il separatore divide le cifre relative a giorno, mese ed anno nella formattazione. Il carattere effettivamente utilizzato come separatore è determinato dalle impostazioni di localizzazione del sistema. Nota: il carattere è da intendersi senza parentesi.

d

Visualizza il giorno del mese come numero senza zero iniziale (ad esempio 1).

dd

Visualizza il giorno del mese formattandolo su due cifre (Ad esempio, 27 o 01)

ddd

Visualizza il nome del giorno abbreviato, nella lingua locale (ad esempio “lun”)

dddd

Visualizza il nome del giorno per intero, nella lingua locale (ad esempio “lunedi”)

M

Visualizza il numero del mese senza zero iniziale (ad esempio, Gennaio è rappresentato con 1).

MM

Visualizza il numero del mese formattato su due cifre (per esempio, Gennaio è rappresentato con 01)

MMM

Visualizza il nome del mese abbreviato, nella lingua locale (ad esempio, gen).

MMMM

Visualizza il nome del mese per intero, nella lingua locale (ad esempio, gennaio).

h

Visualizza l’ora senza zero iniziale con sistema 12-ore (ad es., 2:27:15).

hh

Visualizza l’ora formattata su due cifre, con sistema 12-ore (ad esempio, 02:27:15).

H

Visualizza l’ora senza zero iniziale con sistema 24-ore (ad esempio, 14:27:15).

HH

Visualizza l’ora formattata su due cifre con sistema 24-ore (as esempio, 06:08:15).

m

Visualizza i minuti senza zero iniziale (ad esempio, 12:1:15).

mm

Visualizza i minuti formattati su due cifre (ad esempio, 12:01:15).

s

Visualizza i secondi senza zero iniziale (ad esempio, 12:15:5).

ss

Visualizza i secondi formattati su due cifre (ad esempio, 12:15:05).

w

Visualizza il numero del giorno della settimana. Ad esempio, 1 per lunedì, 2 per martedì, ecc.

La numerazione dei giorni della settimana dipende dalle impostazioni di localizzazione del sistema (ad esempio, 1 identifica il Lunedì per un sistema localizzato per l’Italia, ma rappresenta la Domenica in un sistema localizzato per gli Stati Uniti).

ww

Visualizza il numero della settimana nell’anno (1-51)

y

Visualizza il giorno dell’anno (1-355/6)

yy

Visualizza l’anno formattato su due cifre, con zero iniziale per anni inferiori alla decina. (ad esempio 04 per 2004).

yyyy

Visualizza l’anno su quattro cifre (ad esempio 2004)

Formato

Espress.

Risultato

h:mm:ss

Time

2:05:09

H:mm:ss

Time

14:05:09

HH:mm:ss

Time

02:05:09

dddd d MMMM yyyy

Date

mercoledì 8 settembre 2004

mm/gg/yy

Date

09/08/04

ddd dd MMM yy " – " hh:mm

now

mer 08 set 04 – 09:05

Settimana " ww "giorno " w

Date

Settimana 37 Giorno 3

Sintassi

Descrizione

General Number

Visualizza il numero senza separatore delle migliaia

Currency

Visualizza un numero con i separatori delle migliaia ove appropriato e due cifre decimali, inserendo l’eventuale simbolo di valuta. L’output dipende dalle impostazioni di localizzazione del sistema.

Fixed

Visualizza almeno una cifra a sinistra e due cifre a destra del separatore decimale.

Standard

Visualizza un numero con separatore delle migliaia, ed almeno una cifra a sinistra e due cifre a destra del separatore decimale.

Percent

Visualizza il numero formattato come percentuale (moltiplicato per 100 e seguito dal segno “%”; visualizza sempre due cifre a destra del separatore decimale.

Scientific

Visualizza il numero in notazione scientifica, con due cifre significative decimali.

Yes/No

Visualizza No se il valore numerico dell’espressione è 0; SI se diverso da 0. I testi No e Si sono espressi nella lingua locale.

True/False

Visualizza Falso se il valore numerico dell’espressione è 0; Vero se il valore è diverso da 0. I testi Vero e Falso sono espressi nella lingua locale.

On/Off

Visualizza Off se il valore numerico dell’espressione è 0; On se diverso da 0.

Formato

Espress.

Risultato

Currency

ITEM1

€ 1.234,56

per ITEM1 =1234,567

Percent

ITEM1

5,00 %

per ITEM1 = 0,05

on/off

ITEM1

ON

per Item1 <> 0

OFF

per Item1 = 0

Carattere

Descrizione

(0)

Segnaposto di cifra. Rappresenta uno zero o una cifra diversa da 0. Se l’espressione ha una cifra nella posizione corrispondente alla posizione dello 0 nella stringa di formattazione, tale cifra viene visualizzata; diversamente viene visualizzato uno 0.

Se il numero di cifre del valore da formattare è inferiore al numero 0 nella stringa di formattazione, sia a destra che a sinistra del separatore decimale, vengono visualizzati gli zeri iniziali e finali.

Se il numero di cifre decimali del valore è superiore al numero di 0 a destra del separatore decimale nella stringa di formattazione, il valore viene arrotondato al numero di cifre decimali specificato.

Se il numero di cifre intere del valore è superiore al numero di 0 a sinistra del separatore decimale nella stringa di formattazione, le cifre eccedenti sono visualizzate senza modifiche.

(#)

Segnaposto di cifra. Visualizza una cifra o nulla. Se l’espressione ha una cifra nella posizione corrispondente alla posizione del # nella stringa di formattazione, questa viene visualizzata; diversamente, non viene visualizzato nulla in quella posizione.

Il carattere # opera come il carattere 0, ad eccezione del fatto che gli zeri iniziali e finali non vengono visualizzati se il valore ha un numero di cifre inferiore al numero di #, sia a destra che a sinistra del separatore decimale.

(.)

Segnaposto del separatore decimale. La posizione del separatore decimale determina il numero di cifre della parte intera e della parte decimale.

Se la stringa di formattazione contiene solo # a sinistra del simbolo, I numeri inferiori a 1 iniziano con il separatore decimale (viene omesso lo 0 relativo alle unità). Per visualizzare lo 0 iniziale con I numeri decimali, utilizzare il simbolo 0 come primo segnaposto di cifra a sinistra del separatore.

Il carattere (.) rappresenta solo un segnaposto del separatore nella stringa di formattazione. Il carattere effettivamente visualizzato come separatore decimale nella stringa formattata dipende dalle impostazioni di localizzazione del sistema. Il carattere (.) viene utilizzato indipendentemente dal separatore decimale locale impostato: la stringa formattata apparirà nel formato locale corretto.

(%)

Segnaposto di percentuale. Moltiplica il valore per 100 ed inserisce il carattere % in corrispondenza della posizione in cui tale carattere appare nella stringa di formattazione.

(,)

Segnaposto del separatore delle migliaia. Il separatore delle migliaia separa la cifra delle migliaia dalla cifra delle centinaia in un numero con quattro o più cifre intere.

L’utilizzo standard del separatore delle migliaia prevede che il separatore delle migliaia sia inserito, nella stringa di formattazione, tra segnaposti di cifra (0 o #).

Se il separatore delle migliaia viene invece inserito immediatamente a sinistra del separatore decimale (indipendentemente dal fatto che siano stati inseriti segnaposti di cifre decimali) o viene inserito come carattere all’estrema destra della stringa di formattazione, ciò indica al sistema di scalare il valore dividendolo per 1000 ed eseguendo gli arrotondamenti eventualmente necessari.

Ad esempio, la stringa di formattazione “##0,.” Consente di rappresentare 100 milioni come 100.000 . I numeri inferiori a 1000 ma uguali o maggiori di 500 sono visualizzato come 1, mentre i numeri inferiori a 500 sono visualizzati come 0.

Due separatori di migliaia adiacenti inseriti nella posizione indicata scalano il valore con fattore 1 milione, ed il fattore di scalatura viene aumentato di 1000 ad ogni separatore di migliaia immediatamente adiacente aggiunto. Occorrenze multiple del segnaposto del separatore di migliaia inserite in posizioni differenti da quella indicata e non adiacenti forniscono invece solamente le istruzioni per l’utilizzo del separatore di migliaia secondo l’uso standard.

Il carattere effettivamente utilizzato come separatore di migliaia nella stringa risultante dipende dalle impostazioni di localizzazione del sistema. Il carattere (.) viene utilizzato indipendentemente dal separatore di migliaia locale impostato: la stringa formattata apparirà nel formato locale corretto.

(E- E+ e- e+)

Indicatore di formato scientifico (esponenziale). Se la stringa di formattazione contiene almeno un segnaposto di cifra (0 or #) a sinistra del carattere E-, E+, e-, o e+, il numero è visualizzato in formato scientifico, e  E o e sono inseriti tra il numero ed il suo esponente decimale.

Il numero di segnaposto di cifra a sinistra del simbolo determina il numero di cifre dell’esponente. Utilizzare E- o e-  per inserire il segno – in caso di esponente negativo e nessun segno in caso di esponente positivo; utilizzare E+ o e+ per inserire il segno –  in caso di esponenti positivi ed il segno + in caso di esponenti positivi.

Per il corretto funzionamento della formattazione è necessario che la stringa di formattazione contenga i necessari segnaposto di cifra a destra del simbolo.

- + $ ( )

Caratteri letterali. Questi caratteri sono visualizzati esattamente come inseriti nella stringa di formattazione. Per visualizzare un altro carattere, non compreso tra quelli elencati, occorre farlo precedere da una barra retroversa (\) o racchiuderlo tra doppi apici (" ").

(\)

Inibitore di funzionalità. Consente di visualizzare il carattere immediatamente successivo nella stringa di formattazione esattamente come è scritto, ignorandone il significato simbolico. Il carattere (\) non viene visualizzato. Questa scrittura è equivalente a racchiudere il carattere tra doppi apici (" "). Per visualizzare il carattere barra retroversa (\) inserirne due (\\).

Esempi di caratteri che non possono essere visualizzati se non precedendoli con la barra retroversa sono: i caratteri di formattazione di data e ora (a, c, d, h, m, n, p, q, s, t, w, y, /, :), i caratteri di formattazione numerica (#, 0, %, E, e, virgola e punto), ed i caratteri di formattazione delle stringhe (@, &, <, >, !).

("…")

I caratteri racchiusi tra doppi apici vengono visualizzati esattamente come inseriti, ignorandone il significato simbolico, esattamente come avviene per i caratteri preceduti da (\).

Formato

Espress.

Risultato

000.00

ITEM1

1234,12

per ITEM1 =1234,123

1234,57

per ITEM1=1234,567

012,30

per ITEM1 = 12,3

###.##

ITEM1

1234.12

per ITEM1 =1234,123

1234.57

per ITEM1=1234,567

12,3

per ITEM1 = 12,3

###.00

ITEM1

1234.12

per ITEM1 =1234,123

1234.57

per ITEM1= 1234,567

12,30

per ITEM1 = 12,3

,25

per ITEM1 = 0,25

##0.00

ITEM1

1234.12

per ITEM1 =1234,123

1234.57

per ITEM1=1234,567

12,30

per ITEM1 = 12,3

0,25

per ITEM1 = 0,25

Carattere

Descrizione

@

Segnaposto di carattere. Visualizza un carattere o uno spazio. Se la stringa ha un carattere nella posizione corrispondente a quella di @ nella stringa di formattazione, il carattere viene visualizzato. Diversamente, in quella posizione viene visualizzato uno spazio.

I segnaposto sono compilati da destra a sinistra a meno che la stringa di formattazione contenga il carattere speciale (!).

&

Segnaposto di carattere. Visualizza un carattere o nulla. Se la stringa ha un carattere nella posizione corrispondente a quella di & nella stringa di formattazione, il carattere viene visualizzato. Diversamente, in quella posizione non viene visualizzato nulla.

I segnaposto sono compilati da destra a sinistra a meno che la stringa di formattazione contenga il carattere speciale (!).

< 

Forza la conversione della stringa in lettere minuscole

> 

Forza la conversione della stringa in lettere maiuscole

!

Forza compilazione da sinistra a destra dei segnaposto (per default i segnaposto sono compilati da destra a sinistra).

Formato

Espress.

Risultato

@@@@@

ITEMTX

<4 spazi>A

per ITEMTX= “A”

ABCDEF

per ITEMTX= “ABCDEF”

!@@@@@

ITEMTX

A<4 spazi>

per ITEMTX= “A”

ABCDEF

per ITEMTX= “ABCDEF”

&&&&&

ITEMTX

A

per ITEMTX= “A”

ABCDEF

per ITEMTX= “ABCDEF”

> 

ITEMTX

ABCD

per ITEMTX = “abcd”

< 

ITEMTX

abcd

per ITEMTX = “ABCD”