Funzione MOONPHASE
La funzione MOONPHASE restituisce un valore numerico frazionario che rappresenta la fase della Luna in una data specificata. Il valore indica la sua posizione nel ciclo lunare, detto anche ciclo della lunazione, e distingue una Luna crescente da una Luna calante.
Formato:
- MOONPHASE(Date)
dove Date è una data, eventualmente comprensiva di un orario. A seconda del contesto in cui viene utilizzata la formula, può essere:
- in un rapporto — una colonna contenente una data, ad esempio D;
- in un campo attività calcolato — una variabile di campo data, ad esempio {{Task.Creation date}};
- una stringa di data, ad esempio "11-09-2026 07:02" nel formato MM-DD-YYYY HH:mm.
Il dato inserito viene interpretato nel fuso orario dell'utente, comprese le regole dell'ora legale applicabili a quella data. Se non viene specificato un orario, viene usata la mezzanotte — 00:00.
Valore restituito
La funzione restituisce un numero maggiore di −4 e minore o uguale a 4. I principali valori di riferimento sono:
| Valore | Fase lunare |
|---|---|
| 0 | Luna nuova |
| 1 | Luna crescente — falce crescente |
| 2 | Primo quarto |
| 3 | Luna gibbosa — gibbosa crescente |
| 4 | Luna piena |
| −3 | Luna gibbosa calante — gibbosa calante |
| −2 | Ultimo quarto — detto anche terzo quarto |
| −1 | Luna balsamica — falce calante |
Tra questi valori di riferimento, la funzione restituisce valori frazionari. Ad esempio, 1.5 rappresenta una posizione intermedia tra i valori di riferimento della Luna crescente e del primo quarto.
Per identificare lo stato della Luna:
- 0 — il momento della Luna nuova;
- maggiore di 0 e minore di 4 — Luna crescente;
- 4 — il momento della Luna piena;
- minore di 0 — Luna calante.
Il segno cambia al momento della Luna piena. Subito prima, il valore si avvicina a 4. Al momento della Luna piena, è uguale a 4. Subito dopo, cambia in un valore vicino a −4, quindi aumenta verso 0 man mano che si avvicina la Luna nuova successiva.
La codifica numerica è una convenzione di Planfix. Il valore restituito rappresenta una posizione nel ciclo lunare, non la percentuale della superficie illuminata della Luna.
Precisione del calcolo
Per le date dal 2000 al 2050 compresi, il calcolo utilizza gli orari tabulati delle Lune nuove, dei primi quarti, delle Lune piene e degli ultimi quarti disponibili nelle tabelle NASA. Gli orari tabulati sono arrotondati al minuto più vicino.
I valori tra fasi principali consecutive vengono calcolati mediante interpolazione lineare. I valori intermedi sono quindi approssimativi.
Per le date precedenti al 2000 o successive al 2050, la funzione utilizza un calcolo approssimativo basato sulla durata media di un mese sinodico.
Se una stringa di data non può essere riconosciuta, la funzione restituisce 0.
Esempi
In un rapporto
Restituisce la fase lunare della data nella colonna D:
MOONPHASE(D)
Qui, D è una colonna del rapporto che contiene una data. Sostituisci D con l'identificativo della tua colonna.
In un campo attività calcolato
Restituisce la fase lunare al momento della creazione del compito:
MOONPHASE({{Task.Creation date}})
Restituisce lo stesso valore arrotondato a due cifre decimali:
ROUND(MOONPHASE({{Task.Creation date}}); 2)
Puoi sostituire la data di creazione con qualsiasi variabile di campo data del compito. Inserisci la variabile usando il selettore di variabili nelle impostazioni del campo calcolato.
Quando controlli se si tratta di Luna nuova, Luna piena o di una fase crescente/calante, usa il valore prima dell'arrotondamento. L'arrotondamento può trasformare un valore vicino a 0 o 4 nel corrispondente numero intero.
Usando una stringa di data
MOONPHASE("11-09-2026 07:02")
La data è il 9 novembre 2026. Se il fuso orario dell'utente è UTC, il risultato è 0 — Luna nuova. In un altro fuso orario, la stessa stringa rappresenta un istante diverso, quindi il risultato sarà diverso.