English
Word nu lid
Datum en tijd/probuilder · probacktest · proorder · proscreener

Year

Year geeft het jaar met vier cijfers van een bar op de grafiek, zoals 2026. Year accepteert een offset tussen blokhaken zoals Year[10] om het jaar van een eerdere bar te lezen.

Syntaxis

probuilder
Year[N]

Hoe het werkt

Year geeft het kalenderjaar van de bar die wordt verwerkt terug, als een geheel getal van vier cijfers zoals 2026. Het leest de datum die aan elke bar hangt, dus het verandert langs de tijdas: bars uit 2024 geven 2024 terug, bars uit 2025 geven 2025, en de waarde loopt bij elke jaarwisseling op.

De optionele index N selecteert een bar ten opzichte van de bar die wordt verwerkt. Year[0], of gewoon Year, is de huidige bar. Een positieve N kijkt terug: Year[10] is het jaar van de bar tien posities eerder. De grafiek moet genoeg historie bevatten voor de gevraagde offset, anders is de waarde aan de linkerrand niet gedefinieerd. Year werkt alleen op tijdgebaseerde grafieken, waar elke bar een datum draagt.

Year is het jaar per bar. De verwanten zijn CurrentYear, die het jaar van de klok op het moment van uitvoering leest en op elke bar identiek is, en OpenYear, die het jaar bij de open van elke bar leest. Combineer Year met Month en Day wanneer je een volledige kalenderdatum moet testen.

Voorbeelden

Voorbeeld 1, Jaar van een eerdere bar (Indicator)

probuilder
// Retrieve the year of the bar exactly 10 periods before the current bar
myYear = Year[10]
RETURN myYear

De indicator plot op elk punt het jaar van de bar tien posities terug, een trapvormige lijn die bij elke jaargrens springt, tien bars naar rechts verschoven.

Voorbeeld 2, Scannen op jaar (ProScreener)

probuilder
// Match instruments whose latest bar falls in 2026
thisYear = Year = 2026
SCREENER[thisYear AND close > Average[50](close)] (Year AS "Year")

De screener geeft alleen instrumenten waarvan de meest recente bar 2026 als datum heeft, met het jaar ernaast weergegeven, nuttig wanneer de laatste bar van een grafiek kan achterlopen op de kalender.

Voorbeeld 3, Instapfilter bij jaarwisseling (ProOrder)

probuilder
// Allow entries only on the first bar of a new year
DEFPARAM CumulateOrders = false
newYear = Year > Year[1]
IF newYear AND close CROSSES OVER Average[20](close) THEN
    BUY 1 CONTRACT AT MARKET
ENDIF

De voorwaarde Year > Year[1] is true op de eerste bar van een nieuw kalenderjaar, dus de strategie gebruikt het als jaarlijkse instappoort voor seizoensideeën.

Veelvoorkomende fouten en valkuilen

  • Jaar met vier cijfers. Year geeft een volledig jaar zoals 2026, niet een vorm met twee cijfers. Vergelijkingen moeten het hele getal gebruiken.
  • Alleen tijdgebaseerde grafieken. Year heeft bars nodig die een datum bevatten. Op niet-tijdgebaseerde grafieken is de waarde niet zinvol.
  • Per bar, niet de klok. Year leest de datum van elke bar en verandert langs de as. Voor het jaar van het moment waarop de code draait, gebruik CurrentYear.
  • Offset voorbij de historie. Year[N] vereist N bars historie. Nabij de linkerrand van de grafiek is de waarde niet gedefinieerd.
  • CurrentYear, jaar van de klok op het moment van uitvoering.
  • OpenYear, jaar bij de open van elke bar.
  • Month, maand van elke bar, combineert met Year voor een vollediger datum.
  • Day, dag van de maand van elke bar.
  • DayOfWeek, weekdag van elke bar, 1 voor maandag tot 7 voor zondag.
  • Days, het aantal volledige dagen verstreken sinds 1 januari 1900 tot aan elke bar.
  • TIME, sluitingstijd van elke bar als geheel getal in HHMMSS.
  • Timestamp, UNIX-tijd van de close van elke bar.