closestTo

Trouve la date la plus proche d'une cible dans un itérable de TheDate. 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>
>(
	target: TheDate,
	params?: ClosestToParams
): (input: GenericIterable) => TheDate | undefined

Signature currifiée

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

Paramètres

• target : Date recherchée.
• input : Itérable de TheDate.
• 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