closestTo

Trouve la date la plus proche d'une cible dans un itérable de TheDate ou SerializedTheDate. En cas d'égalité, un tieBreaker optionnel permet de favoriser le passé ou le futur.

Exemple interactif

Syntaxe

interface ClosestToParams {
	tieBreaker?: "favorPast" | "favorFuture";
}

Signature classique

function closestTo<
	GenericIterable extends Iterable<TheDate | SerializedTheDate>
>(
	target: TheDate | SerializedTheDate,
	params?: ClosestToParams
): (input: GenericIterable) => TheDate | undefined

Signature currifiée

function closestTo<
	GenericIterable extends Iterable<TheDate | SerializedTheDate>
>(
	input: GenericIterable,
	target: TheDate | SerializedTheDate,
	params?: ClosestToParams
): TheDate | undefined

Paramètres

• target : Date recherchée (TheDate ou SerializedTheDate).
• input : Itérable de TheDate ou SerializedTheDate.
• tieBreaker : (Optionnel) Gère les égalités (favorPast par défaut).

Valeur de retour

Le TheDate le plus proche, ou undefined si l'itérable est vide.

Voir aussi

• each
• round