Sessioni Orarie IT + Weekend + Alerts

# 📋 DESCRIZIONE ITALIANO

---

# 🇮🇹 Sessioni Orarie Italiane + Weekend + Alert

## 📊 Descrizione

Questo indicatore è stato progettato specificamente per i trader italiani che necessitano di visualizzare orari chiave durante la sessione di trading, identificare i periodi di weekend e **ricevere notifiche automatiche** ai cambi di sessione.

Lo script traccia automaticamente **linee verticali infinite** ai seguenti orari italiani:
- **15:30** - Apertura mercato USA (New York)
- **18:30** - Fine sessione europea / Mid-session USA

Inoltre, evidenzia visualmente tutto il **periodo di weekend** (da Venerdì 20:00 a Domenica 23:00) con uno sfondo colorato personalizzabile.

**🔔 NOVITÀ: Sistema di Alert completo** per non perdere mai l'apertura/chiusura delle sessioni chiave!

---

## ✨ Caratteristiche Principali

### 🕐 Linee Orarie Automatiche
- **15:30 IT** - Linea verticale all'apertura di Wall Street
- **18:30 IT** - Linea verticale di fine sessione europea
- Linee **infinite** che si estendono sopra e sotto il grafico
- Stile completamente **personalizzabile** (colore, larghezza, tipo di linea)
- **Auto-aggiornamento** con gestione automatica ora legale/solare (CET/CEST)

### 🌙 Evidenziazione Weekend
- Sfondo colorato nel periodo: **Venerdì 20:00 → Domenica 23:00**
- Aiuta a identificare rapidamente quando i mercati Forex/Crypto sono meno liquidi
- Colore e trasparenza **completamente personalizzabili**

### 🔔 Sistema Alert Avanzato
- **Alert automatici** per ogni cambio di sessione
- **5 tipi di alert configurabili**:
- 🇺🇸 Apertura New York (15:30 IT)
- 🇪🇺 Fine Sessione Europea (18:30 IT)
- 🌙 Inizio Weekend (Venerdì 20:00 IT)
- ☀️ Fine Weekend (Domenica 23:00 IT)
- ⚠️ Qualsiasi evento (alert combinato)
- **Multi-canale**: Notifiche push, email, popup, webhook
- **Messaggi personalizzati** con emoji e informazioni dettagliate
- **Switch individuale** per ogni tipo di alert

### ⚙️ Caratteristiche Tecniche
- ✅ Funziona su **tutti i timeframe** (da 1 minuto a mensile)
- ✅ Compatibile con **tutti gli strumenti** (Forex, Crypto, Azioni, Indici, Commodities)
- ✅ Fuso orario **Europe/Rome** integrato
- ✅ Gestione automatica DST (Daylight Saving Time)
- ✅ Codice ottimizzato in **Pine Script v6**
- ✅ Label opzionali per identificare gli orari
- ✅ **Alert frequency**: once_per_bar (evita spam di notifiche)

---

## 🎨 Impostazioni Personalizzabili

### Stile Visivo
1. **Colore Linee Orarie** - Scegli il colore che preferisci
2. **Larghezza Linee** - Da 1 a 5 pixel
3. **Stile Linee** - Solid (continua), Dashed (tratteggiata), Dotted (puntinata)
4. **Colore Weekend** - Sfondo personalizzabile con trasparenza

### Alert Settings
1. **Abilita Alert** - Switch master per attivare/disattivare tutti gli alert
2. **Alert ore 15:30** - Notifica apertura New York
3. **Alert ore 18:30** - Notifica fine sessione europea
4. **Alert Inizio Weekend** - Notifica chiusura mercati (Ven 20:00)
5. **Alert Fine Weekend** - Notifica riapertura mercati (Dom 23:00)

---

## 📖 Come Utilizzarlo

### Installazione Base
1. Aggiungi l'indicatore al tuo grafico
2. Le linee appariranno automaticamente alle 15:30 e 18:30 (ora italiana)
3. Il weekend sarà evidenziato con uno sfondo colorato
4. Personalizza colori e stili dalle impostazioni (icona ingranaggio)

### Attivazione Alert

#### Metodo 1: Alert Automatici (Consigliato - Più Semplice)
1. Vai in **Impostazioni** dell'indicatore (icona ingranaggio)
2. Sezione **Alert Settings**
3. Spunta gli alert che vuoi ricevere
4. Gli alert si attivano automaticamente!

#### Metodo 2: Alert Personalizzati (Avanzato)
1. Clicca sul pulsante **⏰ Alert** in alto a destra
2. Seleziona **Condizione** → Nome dell'indicatore
3. Scegli il tipo di alert:
- Apertura NY (15:30)
- Fine EU (18:30)
- Inizio Weekend
- Fine Weekend
- Qualsiasi Sessione
4. Configura le **opzioni di notifica**:
- 📱 Notifica App
- 📧 Email
- 🔊 Popup sonoro
- 🔗 Webhook URL
5. Clicca **Crea**

---

## 🔔 Messaggi Alert

Gli alert includono emoji e informazioni chiare:

**🇺🇸 15:30 IT - APERTURA NEW YORK**
```
Inizio sessione americana
Strumento: [nome]
```

**🇪🇺 18:30 IT - FINE SESSIONE EUROPEA**
```
Mid-session USA
Strumento: [nome]
```

**🌙 VENERDÌ 20:00 - INIZIO WEEKEND**
```
Mercati in chiusura
Riduzione liquidità prevista
```

**☀️ DOMENICA 23:00 - FINE WEEKEND**
```
Riapertura mercati imminente
Preparati per la nuova settimana
```

---

## 🎯 Ideale Per

- 📈 **Day Traders** che operano sulle sessioni USA/EU
- 🌍 **Forex Traders** che vogliono evidenziare il weekend
- 💹 **Scalpers** che necessitano di riferimenti orari precisi
- ⏰ **Swing Traders** che vogliono evitare gap del weekend
- 🇮🇹 **Trader Italiani** che usano il fuso orario locale
- 📱 **Mobile Traders** che vogliono notifiche push

---

## 💡 Perché Usare Questo Indicatore?

- **Risparmia tempo**: Non devi più calcolare manualmente gli orari con fusi diversi
- **Non perdere sessioni**: Alert automatici ti avvisano sempre
- **Chiarezza visiva**: Identifica immediatamente le sessioni chiave
- **Versatile**: Funziona su qualsiasi mercato e timeframe
- **Preciso**: Aggiornamento automatico con ora legale/solare
- **Multi-dispositivo**: Ricevi notifiche su mobile, desktop, email

---

## 📝 Note Importanti

- Le linee orarie vengono disegnate solo quando la candela corrisponde esattamente all'orario target
- L'evidenziazione weekend copre il periodo da Ven 20:00 a Dom 23:00 (ora italiana)
- Gli alert usano `alert.freq_once_per_bar` per evitare spam di notifiche
- Lo script è ottimizzato per non appesantire il grafico
- Gli alert funzionano anche quando il grafico non è aperto (se configurati correttamente)

---

## 🚀 Casi d'Uso

### Scenario 1: Day Trader Forex
- Attiva alert 15:30 per entrare sulle notizie USA
- Attiva alert 18:30 per chiudere posizioni EU
- Visualizza linee per identificare breakout agli orari chiave

### Scenario 2: Swing Trader
- Attiva alert weekend per chiudere posizioni prima del venerdì sera
- Evidenziazione weekend per evitare gap di apertura
- Alert domenica sera per preparare setup settimanali

### Scenario 3: Scalper Intraday
- Linee orarie come riferimento per volatilità
- Alert 15:30 per sfruttare l'aumento di volume NY
- Personalizza colori per non disturbare l'analisi tecnica

---

## 🔄 Aggiornamenti Futuri

Roadmap pianificata:
- [ ] Aggiunta sessione asiatica (Tokyo)
- [ ] Sessione londinese personalizzabile
- [ ] Statistiche volatilità per sessione
- [ ] Alert personalizzabili con messaggi custom
- [ ] Integrazione con Discord/Telegram

**Lascia un commento con le tue richieste!**

---

## ⭐ Ti è Piaciuto?

Se trovi utile questo indicatore:
- Lascia una ⭐ **stella**
- 💬 **Commenta** con feedback o richieste
- 🔄 **Condividilo** con altri trader
- 👤 **Seguimi** per altri script utili!

---

## 🏷️ Tags

`sessioni` `orari` `italia` `weekend` `alert` `notifiche` `fuso-orario` `CET` `CEST` `new-york` `forex` `day-trading` `scalping` `swing-trading` `utilità` `automazione`

---

**Versione**: 2.0 (Alert Update)
**Lingua**: Italiano / English
**Licenza**: Mozilla Public License 2.0
**Autore**: [Il tuo nome]

---

**Buon Trading! 📊🇮🇹**

---
---

# 📋 ENGLISH DESCRIPTION

---

# 🌍 Italian Time Sessions + Weekend + Alerts

## 📊 Description

This indicator is specifically designed for traders who need to visualize key Italian time zones during trading sessions, identify weekend periods, and **receive automatic notifications** at session changes.

The script automatically draws **infinite vertical lines** at the following Italian times:
- **15:30 IT** - US Market Open (New York)
- **18:30 IT** - European Session Close / Mid US Session

Additionally, it visually highlights the entire **weekend period** (from Friday 20:00 to Sunday 23:00) with a customizable colored background.

**🔔 NEW: Complete Alert System** to never miss key session openings/closings!

---

## ✨ Main Features

### 🕐 Automatic Time Lines
- **15:30 IT** - Vertical line at Wall Street opening
- **18:30 IT** - Vertical line at European session close
- **Infinite lines** extending above and below the chart
- Fully **customizable** style (color, width, line type)
- **Auto-update** with automatic DST management (CET/CEST)

### 🌙 Weekend Highlighting
- Colored background during: **Friday 20:00 → Sunday 23:00**
- Helps quickly identify when Forex/Crypto markets are less liquid
- Color and transparency **fully customizable**

### 🔔 Advanced Alert System
- **Automatic alerts** for every session change
- **5 configurable alert types**:
- 🇺🇸 New York Open (15:30 IT)
- 🇪🇺 European Session Close (18:30 IT)
- 🌙 Weekend Start (Friday 20:00 IT)
- ☀️ Weekend End (Sunday 23:00 IT)
- ⚠️ Any Event (combined alert)
- **Multi-channel**: Push notifications, email, popup, webhook
- **Custom messages** with emojis and detailed information
- **Individual switch** for each alert type

### ⚙️ Technical Features
- ✅ Works on **all timeframes** (from 1 minute to monthly)
- ✅ Compatible with **all instruments** (Forex, Crypto, Stocks, Indices, Commodities)
- ✅ Integrated **Europe/Rome** timezone
- ✅ Automatic DST (Daylight Saving Time) management
- ✅ Optimized code in **Pine Script v6**
- ✅ Optional labels to identify times
- ✅ **Alert frequency**: once_per_bar (avoids notification spam)

---

## 🎨 Customizable Settings

### Visual Style
1. **Time Lines Color** - Choose your preferred color
2. **Lines Width** - From 1 to 5 pixels
3. **Lines Style** - Solid, Dashed, Dotted
4. **Weekend Color** - Customizable background with transparency

### Alert Settings
1. **Enable Alerts** - Master switch to activate/deactivate all alerts
2. **Alert 15:30** - New York opening notification
3. **Alert 18:30** - European session close notification
4. **Weekend Start Alert** - Market close notification (Fri 20:00)
5. **Weekend End Alert** - Market reopen notification (Sun 23:00)

---

## 📖 How to Use

### Basic Installation
1. Add the indicator to your chart
2. Lines will automatically appear at 15:30 and 18:30 (Italian time)
3. Weekend will be highlighted with a colored background
4. Customize colors and styles from settings (gear icon)

### Alert Activation

#### Method 1: Automatic Alerts (Recommended - Easiest)
1. Go to indicator **Settings** (gear icon)
2. **Alert Settings** section
3. Check the alerts you want to receive
4. Alerts activate automatically!

#### Method 2: Custom Alerts (Advanced)
1. Click **⏰ Alert** button (top right)
2. Select **Condition** → Indicator name
3. Choose alert type:
- NY Open (15:30)
- EU Close (18:30)
- Weekend Start
- Weekend End
- Any Session
4. Configure **notification options**:
- 📱 App Notification
- 📧 Email
- 🔊 Sound Popup
- 🔗 Webhook URL
5. Click **Create**

---

## 🔔 Alert Messages

Alerts include emojis and clear information:

**🇺🇸 15:30 IT - NEW YORK OPEN**
```
US session start
Instrument: [name]
```

**🇪🇺 18:30 IT - EUROPEAN SESSION CLOSE**
```
Mid US session
Instrument: [name]
```

**🌙 FRIDAY 20:00 - WEEKEND START**
```
Markets closing
Reduced liquidity expected
```

**☀️ SUNDAY 23:00 - WEEKEND END**
```
Markets reopening soon
Get ready for the new week
```

---

## 🎯 Ideal For

- 📈 **Day Traders** operating on US/EU sessions
- 🌍 **Forex Traders** who want to highlight weekends
- 💹 **Scalpers** who need precise time references
- ⏰ **Swing Traders** who want to avoid weekend gaps
- 🇮🇹 **European Traders** using Italian timezone
- 📱 **Mobile Traders** who want push notifications

---

## 💡 Why Use This Indicator?

- **Save time**: No more manual timezone calculations
- **Never miss sessions**: Automatic alerts always notify you
- **Visual clarity**: Immediately identify key sessions
- **Versatile**: Works on any market and timeframe
- **Accurate**: Automatic update with DST
- **Multi-device**: Receive notifications on mobile, desktop, email

---

## 📝 Important Notes

- Time lines are drawn only when the candle matches exactly the target time
- Weekend highlighting covers the period from Fri 20:00 to Sun 23:00 (Italian time)
- Alerts use `alert.freq_once_per_bar` to avoid notification spam
- Script is optimized to not overload the chart
- Alerts work even when the chart is not open (if configured correctly)

---

## 🚀 Use Cases

### Scenario 1: Forex Day Trader
- Activate 15:30 alert to enter on US news
- Activate 18:30 alert to close EU positions
- Visualize lines to identify breakouts at key times

### Scenario 2: Swing Trader
- Activate weekend alerts to close positions before Friday evening
- Weekend highlighting to avoid opening gaps
- Sunday evening alert to prepare weekly setups

### Scenario 3: Intraday Scalper
- Time lines as reference for volatility
- 15:30 alert to exploit NY volume increase
- Customize colors to not disturb technical analysis

---

## 🔄 Future Updates

Planned roadmap:
- [ ] Asian session addition (Tokyo)
- [ ] Customizable London session
- [ ] Volatility statistics per session
- [ ] Customizable alerts with custom messages
- [ ] Discord/Telegram integration

**Leave a comment with your requests!**

---

## ⭐ Did You Like It?

If you find this indicator useful:
- Leave a ⭐ **star**
- 💬 **Comment** with feedback or requests
- 🔄 **Share** with other traders
- 👤 **Follow me** for more useful scripts!

---

## 🏷️ Tags

`sessions` `times` `italy` `weekend` `alerts` `notifications` `timezone` `CET` `CEST` `new-york` `forex` `day-trading` `scalping` `swing-trading` `utility` `automation`

---

**Version**: 2.0 (Alert Update)
**Language**: Italian / English
**License**: Mozilla Public License 2.0
**Author**: [Your name]

---

**Happy Trading! 📊🌍**