dash–calculator

04 Numbers and Counting

Days After B/L Date: Meaning & Shipping Timeline

Readout 04-0326 · Updated · Standard formula, shown below

The calculator on this page is switched off while it is checked. The formula is below, and the worked example shows how to do the sum by hand.

Days after B/L date refers to the number of calendar days that have passed since the Bill of Lading (B/L) was issued, which is the official date the cargo was loaded onto the vessel. It is the standard reference point used in shipping contracts, letters of credit, and demurrage/detention calculations to measure time periods like free time, laytime, and delivery deadlines. Enter the B/L date and today’s date (or any target date) below to calculate how many days have elapsed.

Formula

The calculation is straightforward: subtract the Bill of Lading date from the target date, then convert the difference from milliseconds to days. Both dates are treated as calendar dates, meaning the count includes weekends and holidays unless the underlying contract explicitly excludes them.

Days after B/L = (Target Date − B/L Date) ÷ 86,400,000

Where:
• Target Date is the date you are measuring to (e.g., today, the discharge date, or the free-time expiry).
• B/L Date is the date printed on the Bill of Lading, typically the date the goods are loaded on board the vessel.
• 86,400,000 is the number of milliseconds in one day (24 hours × 60 minutes × 60 seconds × 1,000 ms).

The calculator treats dates as JavaScript timestamps (milliseconds since January 1, 1970). If the target date is earlier than the B/L date, the result shows “Cannot compute” rather than a negative number, because a negative day count has no practical meaning in shipping.

Worked Example

Using the default values: B/L date = 2025-01-15, target date = 2025-02-10.

Step 1: Convert both dates to timestamps.
• 2025-01-15 00:00 UTC = 1,737,475,200,000 ms
• 2025-02-10 00:00 UTC = 1,738,310,400,000 ms

Step 2: Subtract the B/L timestamp from the target timestamp.
1,738,310,400,000 − 1,737,475,200,000 = 835,200,000 ms

Step 3: Divide by milliseconds per day.
835,200,000 ÷ 86,400,000 = 9.666… days

Step 4: Round to one decimal place.
9.7 days after the B/L date

This matches the calculator’s headline output. Note that the result is a fractional number because the target date is a specific point in time; if you need whole calendar days, you would typically round up to 10 days for contractual purposes, but the raw elapsed time is 9.7 days.

Why the B/L Date Matters in Shipping

The Bill of Lading date is one of the most important dates in international trade because it serves as legal proof of when the cargo was loaded. It appears on the document itself, usually as “Shipped on Board Date” or “Date of Issue,” and it triggers several contractual timelines:

  • Letter of Credit (L/C) deadlines: Banks require that documents be presented within a certain number of days after the B/L date (commonly 10, 15, or 21 days). Missing this window can result in a discrepancy and refusal of payment.
  • Free time at destination: Most carriers allow a free period (e.g., 5, 7, or 14 calendar days) after the vessel arrives or after discharge, but the B/L date is the anchor for calculating when that free time starts in some contracts.
  • Demurrage and detention: If containers are not returned or picked up within the allowed free time, charges accrue on a per-day basis, often counted from the B/L date or the discharge date depending on the carrier’s tariff.
  • Delivery deadlines: Buyers and sellers often agree that goods must arrive at a port or warehouse within X days after the B/L date, which affects scheduling and penalties.

Because the B/L date is the official loading date, it is the reference point that both parties can verify from a single document, avoiding disputes about when the shipment actually started.

How to Read the Result

The number you get is the elapsed time in days, including fractions. For practical shipping purposes, you will usually interpret it in one of three ways:

  • Whole calendar days: If you need to know how many full days have passed, round down to the nearest whole number (e.g., 9.7 becomes 9 full days).
  • Contractual days: Many contracts count any part of a day as a full day, so 9.7 days would be treated as 10 days for deadline purposes.
  • Business days: If the contract specifies business days, you must exclude weekends and holidays manually. This calculator does not do that automatically because holiday calendars vary by country and carrier.

For example, if your letter of credit requires document presentation within 15 days after the B/L date, and your B/L date is January 15, you must present documents by January 30 (15 calendar days later). If you use the calculator and get 15.2 days on January 30, you are still within the limit because the 15-day period ends at the end of the 15th day, not at the start.

Common Mistakes and Misconceptions

One frequent error is confusing the B/L date with the vessel’s departure date or the date of arrival. The B/L date is when the cargo is loaded on board, which may be the same day as departure or up to a day or two earlier if loading takes time. Always check the “Shipped on Board” line on the document, not the vessel schedule.

Another mistake is counting the B/L date itself as day 1. In most contracts, the day after the B/L date is day 1. For example, if the B/L date is January 15 and you have 5 free days, day 1 is January 16, and the free time expires at the end of January 20. If you count January 15 as day 1, you will think you have an extra day, which can lead to unexpected demurrage charges.

A third issue is time zones. The calculator uses UTC dates, but the B/L date is a calendar date, not a time. As long as you enter the date as printed on the document, the result is correct regardless of where you are. However, if you are calculating “today” and your local date differs from UTC (e.g., you are in a time zone ahead of UTC), the result may be off by one day. To avoid this, use the date on your local calendar, not the UTC date.

Limitations of the Calculation

This calculator provides the raw elapsed time in days, but it does not account for several contractual nuances that you may need to handle separately:

  • Weekends and holidays: Some contracts (especially for demurrage) count only working days or exclude Sundays and public holidays. You must adjust the result manually.
  • Time of day: If the B/L date includes a specific time (e.g., “January 15, 14:00”), the calculation should use that time, not midnight. Most B/Ls only show the date, so midnight is the standard assumption.
  • Different start points: Some contracts start counting from the vessel’s arrival date, the notice of readiness, or the discharge date rather than the B/L date. Confirm which date is the trigger before relying on this number.
  • Leap years: The calculation handles leap years automatically because it uses actual timestamps. February 29 is included correctly.

If you are using this for a letter of credit, always cross-check the calculation against the bank’s own counting method, which may differ slightly (e.g., counting the B/L date as day 0 or day 1).

Alternatives to the B/L Date as a Reference

While the B/L date is common, it is not the only reference point used in shipping contracts. Depending on the agreement, you may need to count from:

  • Vessel arrival date: The date the ship arrives at the destination port, often used for laytime calculations.
  • Notice of Readiness (NOR): The date the vessel is ready to load or discharge, which may be tendered before arrival.
  • Discharge date: The date the cargo is actually unloaded, commonly used for detention calculations.
  • Container return date: The date the empty container is returned to the depot, used to calculate detention charges.

If your contract uses one of these, simply replace the B/L date in the calculator with that date to get the correct elapsed days. The math is identical; only the starting point changes.

Practical Tips for Shipping Professionals

To avoid disputes and unexpected charges, keep the following in mind:

  • Always record the B/L date exactly as printed on the document, not the date you received the document or the date the vessel sailed.
  • Set reminders for key deadlines (document presentation, free time expiry, container return) based on the B/L date plus the contractual number of days.
  • When in doubt about whether a day is counted, ask the carrier or the bank in writing. Verbal agreements are hard to enforce later.
  • For international shipments, be aware that the B/L date may be in a different time zone than your office. The date on the document is the controlling date, not your local date.

Using this calculator regularly can help you track multiple shipments and avoid costly demurrage or letter of credit discrepancies. Enter the B/L date and today’s date to get an immediate answer, and adjust for business days or holidays as your contract requires.

Frequently Asked Questions

Is the B/L date the same as the shipment date?
Not always. The B/L date is the date the cargo is loaded on board the vessel, which is usually the shipment date, but it can differ if loading spans multiple days or if the vessel departs later. The B/L date is the legally binding date, so always use it for calculations.

How do I count days after the B/L date for a letter of credit?
Count the day after the B/L date as day 1. For example, if the B/L date is March 1 and the L/C requires presentation within 10 days, the deadline is March 11 (not March 10). Confirm with your bank, as some use “within 10 days” to mean 10 full days after, which is the same as the 11th day.

Do weekends count in days after B/L date?
It depends on the contract. For letters of credit, calendar days are used unless the L/C specifies otherwise. For demurrage and detention, carriers often count calendar days but may exclude Sundays or holidays in certain ports. Check the specific tariff or agreement.

What if the B/L date is a Sunday or holiday?
The B/L date is whatever date is printed on the document, even if it falls on a weekend or holiday. The count starts the next day. Shipping operations run 24/7, so a Sunday B/L date is common and does not change the calculation.

Can I use the arrival date instead of the B/L date?
Yes, if your contract specifies arrival date as the reference. However, you must use the same reference consistently. Mixing B/L date and arrival date in the same calculation will give incorrect results. The calculator works with any start date you enter.

Why does the calculator show a decimal like 9.7 days?
Because the target date is a specific point in time, the elapsed time is not always a whole number. For example, from January 15 to February 10 is 26 days, but from January 15 to February 10 at 16:00 is 26.67 days. The decimal reflects the exact fraction of the day that has passed.

Related

Formula used
in bl | B/L date (YYYY-MM-DD) | - | 2025-01-15 | 2000-01-01 | 2100-12-31
in td | Today or target date (YYYY-MM-DD) | - | 2025-02-10 | 2000-01-01 | 2100-12-31
out days | Days after B/L date | days | (td - bl) / 86400000 + 0 * sqrt(max(0, bl - td)) | 1

Each line is one input (in, sel, list) or one result (out: label, unit, formula, decimals). How the calculators work

Method: the standard formula for this calculation, rounded as each result states. See how the calculators work or report an error.

More on this panel

The whole Numbers and Counting panel →