ClosingTimeCountdown
defines the duration (in milliseconds) used to control how long an item stays in its closing phase โ and how long that phase is extended when new bids are received.๐ง Required When: closingMethod = OVERLAPPING
Any sale using the
OVERLAPPING
closing method must set this value.It ensures that every item in the sale has a clear, consistent rule for how long it can stay open once it begins closing.
๐ How It Works
- When an item enters
ITEM_CLOSING
, itsclosingEnd
is initialized as:
closingEnd = closingStart + closingTimeCountdown
- If a bid is placed after
closingStart
but beforeclosingEnd
, the countdown is reset:
closingEnd = now() + closingTimeCountdown
๐ง This creates an anti-sniping mechanism โ every valid bid placed in the final moments of an auction resets the clock, giving other bidders a fair chance to respond.
๐งช Example
If
closingTimeCountdown = 120000
(2 minutes):- At 10:00:00 โ item enters closing
โ
closingEnd = 10:02:00
- A bid is placed at 10:01:15
โ
closingEnd = 10:03:15
- Another bid comes at 10:02:45
โ
closingEnd = 10:04:45
โณ The auction keeps extending โ but never more than 2 minutes ahead of the current time.