Moon Phases in Google Sheets & Excel

What this pulls

Look up the lunar phase by the row. Returns the moon phase for any date down a column — Sheets or Excel.

It's one of 250+ live sources you reach with a single =VERVE() function — served from APIVerve's production data engine, billed at 1 credit per resolved cell, and refreshed on whatever cadence you set. No API keys to wrangle, no scripts, no exports.

See it in a cell

A real example — the input you type, and the values you can pull from it. Click any cell to see the formula behind it.

moonphases.xlsxsample data

A2fx=VERVE("moonphases", "field", "phase")

Phase

Phase Emoji

Illumination

Waxing

Waning

Waning Crescent

🌘

9.9

FALSE

TRUE

click any cell to see its formula1 credit / cell

Ways to use it

One value per row

Fill =VERVE("moonphases", "field", "phase") down a column and Moon Phases returns a result for every row — a batch of live values in a single drag, no code.

Enrich data in place

Add Moon Phases beside a table you already have to append its output right where your data lives, then sort, filter, or chart on it.

Stays fresh on its own

Set the sheet to refresh on a schedule and the moon phases values keep themselves current without anyone re-typing.

Use it in your sheet

The same function works in both apps — install once, sign in with your key, and type it into any cell.

Google SheetsAdd-on

Install from the Workspace Marketplace, then drop the formula into a cell. Autocomplete suggests the source and its fields.

=VERVE("moonphases", "field", "phase")

Microsoft ExcelAdd-in

Same source, same arguments, same key — in Excel on desktop, the web, or mobile. Excel namespaces it as VERVE.CALL. Drag to fill a whole column.

=VERVE.CALL("moonphases", "field", "phase")

Optional inputs

Tune the result by adding name=value before the field argument — in any order. Leave one out and its default applies.

today
Get the moon phase for today
=VERVE("moonphases", "today", "true")

Fields you can pull

Add a field name as the last argument to land just that value in the cell.

Phase
=VERVE("moonphases", "field", "phase")
Phase Emoji
=VERVE("moonphases", "field", "phaseEmoji")
Illumination
=VERVE("moonphases", "field", "illumination")
Waxing
=VERVE("moonphases", "field", "waxing")
Waning
=VERVE("moonphases", "field", "waning")
Lunar Age
=VERVE("moonphases", "field", "lunarAge")
Lunar Age Percent
=VERVE("moonphases", "field", "lunarAgePercent")
Lunation Number
=VERVE("moonphases", "field", "lunationNumber")
Lunar Distance
=VERVE("moonphases", "field", "lunarDistance")
Next Full Moon
=VERVE("moonphases", "field", "nextFullMoon")
Last Full Moon
=VERVE("moonphases", "field", "lastFullMoon")
Days To Full Moon
=VERVE("moonphases", "field", "daysToFullMoon")

Moon Phases, answered

Everything you need to wire it into a sheet.

How do I pull Moon Phases into Google Sheets?

Install the VerveSheets add-on, sign in once with your key, and type =VERVE("moonphases", "field", "phase") into any cell. The "field" argument names the value you want back, so the cell resolves to a single number or string you can chart, sort, or feed into another formula.

What data can I pull from Moon Phases?

Moon Phases returns phase, phaseEmoji, illumination, waxing and waning, plus 7 more — name any one of them as the "field" argument and that value lands in the cell. Leave the field out and the whole record spills into a two-column table instead.

Can I narrow what Moon Phases returns?

Yes — Moon Phases takes "today" as optional inputs. They go in as "name", value pairs after the required ones, in any order, so =VERVE("moonphases", "today", "true") shapes the result without changing anything else.

Can I fill a whole column of Moon Phases at once?

Yes. Reference a range instead of a single cell and one call returns a value for every row, or drag =VERVE("moonphases") down like any spreadsheet function.

How many credits does each Moon Phases cell cost?

Each resolved cell costs 1 credit. A cell only re-bills when it actually refreshes, so a sheet you aren't touching doesn't keep charging.

Does Moon Phases work in Excel as well as Google Sheets?

Yes — same arguments, same key, same fields. Excel namespaces custom functions, so the call is =VERVE.CALL() there and =VERVE() in Google Sheets; nothing else about it changes.

Moon Phases

One value per row

Enrich data in place

Stays fresh on its own

Moon Phases, answered

Put Moon Phases in your next spreadsheet. Add the extension, paste the formula, and the cell keeps itself current.

Scaling up?