Funcția MOONPHASE
Funcția MOONPHASE returnează o valoare numerică fracționară care reprezintă faza Lunii la o dată specificată. Valoarea indică poziția acesteia în ciclul lunar, numit și ciclu de lunație, și face distincția dintre Luna în creștere și Luna în descreștere.
Format:
- MOONPHASE(Date)
unde Date este o dată, care poate include opțional și o oră. În funcție de locul în care este utilizată formula, aceasta poate fi:
- într-un raport — o coloană care conține o dată, de exemplu D;
- într-un câmp de sarcină calculat — o variabilă pentru un câmp de dată, de exemplu {{Task.Creation date}};
- un șir de dată, de exemplu "11-09-2026 07:02", în formatul MM-DD-YYYY HH:mm.
Valoarea introdusă este interpretată în fusul orar al utilizatorului, inclusiv ținând cont de regulile privind ora de vară aplicabile la data respectivă. Dacă nu este specificată o oră, se folosește miezul nopții — 00:00.
Valoarea returnată
Funcția returnează un număr mai mare decât −4 și mai mic sau egal cu 4. Principalele valori de referință sunt:
| Valoare | Faza Lunii |
|---|---|
| 0 | Lună nouă |
| 1 | Lună în creștere — semilună în creștere |
| 2 | Primul pătrar |
| 3 | Lună gibboasă — Lună în creștere, aproape plină |
| 4 | Lună plină |
| −3 | Lună gibboasă în descreștere |
| −2 | Ultimul pătrar — numit și al treilea pătrar |
| −1 | Lună veche — semilună în descreștere |
Între aceste valori de referință, funcția returnează valori fracționare. De exemplu, 1.5 reprezintă o poziție între valorile de referință pentru Luna în creștere și primul pătrar.
Pentru a identifica starea Lunii:
- 0 — momentul Lunii noi;
- mai mare decât 0 și mai mică decât 4 — Luna este în creștere;
- 4 — momentul Lunii pline;
- mai mică decât 0 — Luna este în descreștere.
Semnul se schimbă la Luna plină. Imediat înainte de aceasta, valoarea se apropie de 4. În momentul Lunii pline, valoarea este egală cu 4. Imediat după aceea, devine o valoare apropiată de −4, apoi crește spre 0 pe măsură ce se apropie următoarea Lună nouă.
Această reprezentare numerică este o convenție Planfix. Valoarea returnată reprezintă o poziție în ciclul lunar, nu procentul din suprafața Lunii iluminată.
Precizia calculului
Pentru datele din intervalul 2000–2050 inclusiv, calculul folosește orele tabelate pentru Lunile noi, primul pătrar, Lunile pline și ultimul pătrar din tabelele NASA. Orele din tabele sunt rotunjite la cel mai apropiat minut.
Valorile dintre fazele principale consecutive sunt calculate prin interpolare liniară. Prin urmare, valorile intermediare sunt aproximative.
Pentru datele anterioare anului 2000 sau ulterioare anului 2050, funcția folosește un calcul aproximativ bazat pe durata medie a unei luni sinodice.
Dacă un șir de dată nu poate fi recunoscut, funcția returnează 0.
Exemple
Într-un raport
Returnați faza Lunii pentru data din coloana D:
MOONPHASE(D)
Aici, D este o coloană din raport care conține o dată. Înlocuiți D cu identificatorul coloanei dorite.
Într-un câmp de sarcină calculat
Returnați faza Lunii la momentul creării sarcinii:
MOONPHASE({{Task.Creation date}})
Returnați aceeași valoare rotunjită la două zecimale:
ROUND(MOONPHASE({{Task.Creation date}}); 2)
Puteți înlocui data creării cu variabila oricărui câmp de dată al sarcinii. Inserați variabila folosind selectorul de variabile din setările câmpului calculat.
Când verificați dacă este Lună nouă, Lună plină sau dacă Luna este în creștere ori în descreștere, folosiți valoarea înainte de rotunjire. Rotunjirea poate transforma o valoare apropiată de 0 sau 4 în numărul întreg corespunzător.
Folosind un șir de dată
MOONPHASE("11-09-2026 07:02")
Data este 9 noiembrie 2026. Dacă fusul orar al utilizatorului este UTC, rezultatul este 0 — Lună nouă. În alt fus orar, același șir reprezintă un moment diferit, deci rezultatul va fi diferit.