Nome Attributo | Tipo | Obbligatorio | Default | Descrizione |
---|---|---|---|---|
prefix | stringa | no | Date_ | prefisso per i nomi delle variabili |
time | timestamp/YYYY-MM-DD | no | data attuale in formato unix timestamp o YYYY-MM-DD | data preselezionata |
start_year | stringa | no | anno corrente | primo anno visualizzato: può essere in valore assoluto o relativo all'anno corrente(+/- N) |
end_year | stringa | no | uguale a start_year | ultimo anno visualizzato: può essere in valore assoluto o relativo all'anno corrente(+/- N) |
display_days | booleano | no | true | se visualizzare i giorni oppure no |
display_months | booleano | no | true | se visualizzare i mesi oppure no |
display_years | booleano | no | true | se visualizzare gli anni oppure no |
month_format | stringa | no | %B | formato per i mesi in output (strftime) |
day_format | stringa | no | %02d | formato per i giorni in output (sprintf) |
day_value_format | string | no | %d | formato per il valore dei giorni (sprintf) |
year_as_text | booleano | no | false | se visualizzare gli anni in forma testuale oppure no |
reverse_years | booleano | no | false | se visualizzare gli anni in ordine inverso |
field_array | stringa | no | null | se viene fornito un nome, le caselle select verranno create in modo che il risultato venga fornito a PHP nella forma nome[Day], nome[Year], nome[Month]. |
day_size | stringa | no | null | se presente aggiunge l'attributo size al tag select |
month_size | stringa | no | null | se presente aggiunge l'attributo size al tag select |
year_size | stringa | no | null | se presente aggiunge l'attributo size al tag select |
all_extra | stringa | no | null | se presente aggiunge attributi extra a tutti i tag select |
day_extra | stringa | no | null | se presente aggiunge attributi extra ai tag select/input |
month_extra | stringa | no | null | se presente aggiunge attributi extra ai tag select/input |
year_extra | stringa | no | null | se presente aggiunge attributi extra ai tag select/input |
field_order | stringa | no | MDY | ordine di visualizzazione dei campi (mese, giorno, anno) |
field_separator | stringa | no | \n | stringa di separazione fra i campi |
month_value_format | stringa | no | %m | formato strftime per i valori dei mesi |
year_empty | stringa | no | null | Se presente, il primo elemento della casella select per gli anni conterrà questo valore come output e "" come valore. E' utile per mostrare, ad esempio, sul menù a discesa la frase "Selezionare l'anno". Notate che potete utilizzare valori del tipo "-MM-DD" nell'attributo time per indicare che l'anno non deve essere preselezionato. |
month_empty | stringa | no | null | Se presente, il primo elemento della casella select per i mesi conterrà questo valore come output e "" come valore. Notate che potete utilizzare valori del tipo "YYYY---DD" nell'attributo time per indicare che il mese non deve essere preselezionato. |
day_empty | stringa | no | null | Se presente, il primo elemento della casella select per i giorni conterrà questo valore come output e "" come valore. Notate che potete utilizzare valori del tipo "YYYY-MM-" nell'attributo time per indicare che il giorno non deve essere preselezionato. |
html_select_date è una funzione utente che crea per voi menù a discesa per le date. Può mostrare anno, mese e giorno o solo qualcuno di questi valori.
L'attributo time può avere diversi formati: può essere un timestamp UNIX o una stringa di tipo Y-M-D (anno-mese-giorno). Il formato più comune sarebbe YYYY-MM-DD, ma vengono riconosciuti anche mesi e giorni con meno di due cifre. Se uno dei tre valori (Y,M,D) è una stringa vuota, il campo select corrispondente non avrà nessuna preselezione. Ciò è utile in special modo con gli attributi year_empty, month_empty e day_empty.
Example 8.10. html_select_date
{html_select_date} +
Questo stamperà:
<select name="Date_Month"> <option value="1">January</option> <option value="2">February</option> <option value="3">March</option> <option value="4">April</option> <option value="5">May</option> <option value="6">June</option> <option value="7">July</option> <option value="8">August</option> <option value="9">September</option> <option value="10">October</option> <option value="11">November</option> <option value="12" selected="selected">December</option> </select> <select name="Date_Day"> <option value="1">01</option> <option value="2">02</option> <option value="3">03</option> <option value="4">04</option> <option value="5">05</option> <option value="6">06</option> <option value="7">07</option> <option value="8">08</option> <option value="9">09</option> <option value="10">10</option> <option value="11">11</option> <option value="12">12</option> <option value="13" selected="selected">13</option> <option value="14">14</option> <option value="15">15</option> <option value="16">16</option> <option value="17">17</option> <option value="18">18</option> <option value="19">19</option> <option value="20">20</option> <option value="21">21</option> <option value="22">22</option> <option value="23">23</option> <option value="24">24</option> <option value="25">25</option> <option value="26">26</option> <option value="27">27</option> <option value="28">28</option> <option value="29">29</option> <option value="30">30</option> <option value="31">31</option> </select> <select name="Date_Year"> <option value="2001" selected="selected">2001</option> </select>
Example 8.11. html_select_date
{* l'anno iniziale e finale possono essere relativi a quello corrente *} {html_select_date prefix="StartDate" time=$time start_year="-5" end_year="+1" display_days=false} +
Questo stamperà: (l'anno corrente è il 2000)
<select name="StartDateMonth"> <option value="1">January</option> <option value="2">February</option> <option value="3">March</option> <option value="4">April</option> <option value="5">May</option> <option value="6">June</option> <option value="7">July</option> <option value="8">August</option> <option value="9">September</option> <option value="10">October</option> <option value="11">November</option> <option value="12" selected="selected">December</option> </select> <select name="StartDateYear"> <option value="1995">1995</option> <option value="1996">1996</option> <option value="1997">1997</option> <option value="1998">1998</option> <option value="1999">1999</option> <option value="2000" selected="selected">2000</option> <option value="2001">2001</option> </select>