ForHosting KIT · Developer Utilities

Hebrew Year Length Calculator

The Hebrew year length calculator returns the exact number of days in a numbered Hebrew calendar year.

● BetaFree · in your browser
Use it from WebAPIEmailTelegramApp soon

Because both leap months and calendar postponement rules affect the result, a year can have one of six valid lengths: 353, 354, or 355 days in a common year, and 383, 384, or 385 days in a leap year. The result also labels the year deficient, regular, or complete and reports whether it is a leap year, making the output convenient for calendar software, research, scheduling, and data validation.

Why Hebrew years have six possible lengths

The Hebrew calendar is lunisolar: its months follow lunar cycles while its leap-year pattern keeps festivals in their intended seasons. A common year contains twelve months, and a leap year adds a thirteenth month. That distinction creates two broad ranges, but it does not determine the final total by itself. The lengths of Cheshvan and Kislev can vary, producing deficient, regular, and complete forms. A deficient common year has 353 days, a regular common year has 354, and a complete common year has 355. Their leap-year counterparts have 383, 384, and 385 days. This calculator resolves all of those rules from the Hebrew year number alone. Its response includes the original year, the exact day count, a classification, and a leap-year flag. That compact structure is useful when a program needs a reliable value rather than a formatted calendar or a conversion tied to a civil date. No location, clock, or contemporary calendar service is needed.

How the deterministic calculation works

The calculation first counts the lunar months elapsed before Tishri of the requested year using the fixed nineteen-year Metonic cycle. It then computes the traditional molad parts and applies the Hebrew calendar postponement arithmetic to obtain an integer day number for Rosh Hashanah. The same operation is performed for the following Hebrew year, and subtracting the two day numbers gives the requested year length. This is more dependable than assembling a list of month lengths from an assumed year type, because the year type is precisely what must be discovered. Every operation is bounded integer multiplication, division, remainder, comparison, or subtraction. The implementation does not call JavaScript Date, inspect a machine timezone, read the current time, use randomness, or contact a network service. Consequently, the same input produces the same JSON result in UTC and in every other runtime timezone. The accepted range is deliberately finite so all intermediate integers remain safely exact in JavaScript number arithmetic.

Reading and using the result

Send the Hebrew year as an integer, for example 5784, rather than a Gregorian year or a text label. The days field is the full span from Rosh Hashanah of that year to Rosh Hashanah of the next. The leap field tells you whether the result belongs to the twelve-month common group or the thirteen-month leap group. The classification field describes the variable shape: deficient means one day below the group’s regular length, regular means the middle length, and complete means one day above it. This terminology lets downstream systems reason about Cheshvan and Kislev without guessing from the total. Calendar generators can select month tables, import pipelines can reject inconsistent records, and educational tools can demonstrate cycle behavior. Treat the Hebrew year number as its own calendar coordinate; do not infer it by merely adding a constant to a Gregorian year near January, because Hebrew years begin in Tishri and overlap parts of two Gregorian years. API requests are priced at $0.002.

Build a Hebrew calendar

Select the correct common or leap month-length table before generating dates for a numbered Hebrew year.

Validate calendar data

Check that a stored Hebrew year and its claimed number of days form one of the six valid combinations.

Teach calendar structure

Show how leap status and deficient, regular, or complete forms combine to produce six year lengths.

What values can the calculator return?

It returns 353, 354, or 355 days for a common year, and 383, 384, or 385 days for a leap year.

What do deficient, regular, and complete mean?

They mean the year is respectively one day shorter than, equal to, or one day longer than the regular length for its common or leap group.

Does this use my timezone?

No. It uses fixed integer calendar arithmetic and never reads a clock or timezone, so the result is deterministic in UTC.

Should I enter a Gregorian year?

No. Enter the Hebrew calendar year number, such as 5784.

How much does an API request cost?

Each API request costs $0.002. The calculation has no usage-based unit surcharge.

Everything on this page is available programmatically. This section is for teams who want to wire it into their own systems; everyone else can just use the tool above.

POSThttps://api.kit.forhosting.com/date/hebrew-year-length

Prefer to automate it? One authenticated POST creates the task; the result comes back by webhook or a signed link. The same capability also runs here on the web, by email and from Telegram — and soon from our app too.

curl -X POST https://api.kit.forhosting.com/date/hebrew-year-length \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"year":5784}'
{
  "year": 5784
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "date.hebrew_year_length",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

The API is asynchronous: the call returns a task_id immediately and the result arrives by webhook. Polling is capped at 1 req/s per task.

Per request$0.002

Published price — no tokens, no invented credits. A failed task is never charged.

HTTPCodeMeaning
401unauthorizedMissing or invalid API key.
402insufficient_balanceYour balance doesn't cover the task price.
404unknown_typeThat task type doesn't exist.
429rate_limitedToo many requests. Use the webhook instead of polling.

Read the full KIT documentation →