Valida las fechas y las horas de trabajo del CSV, y guarda el número de registros y las horas totales de cada mes en un CSV y un gráfico de barras.
La traducción se ha realizado con IA. Comprueba el código, las unidades y los valores junto con el original. La revisión por hablantes nativos de cada idioma aún no se ha completado. 한국어
Para quién esPersonal administrativo que quiere automatizar los resúmenes mensuales recurrentes con código sencillo de Python
Cada fila se considera un registro de trabajo y sus hours se suman al mes de date. record_count cuenta filas, no personas ni días trabajados. hours expresa horas decimales: 1.50 significa 1 hora y 30 minutos, no 1 hora y 50 minutos.
Los datos incluidos son 9 registros de trabajo ficticios de los meses 1~3 de 2026. No es una herramienta para medir el tiempo trabajado ni evaluar el rendimiento, sino una práctica para sumar por mes cifras ya introducidas.
| Columna | Formato | Criterio de comprobación |
|---|---|---|
| record_id | Texto como R001 | Debe ser único dentro del archivo |
| date | 2026-01-06 | YYYY-MM-DD, una fecha real |
| task | 자료 정리 | No puede estar vacío |
| hours | 2.50 | Número finito mayor o igual que 0, con un máximo de dos decimales |
No incluyas filas de título, filas de totales ni números con comas. Si se detecta un ID duplicado, el programa se detiene para evitar un doble recuento. Aunque la tarea sea la misma, los ID distintos se suman como registros diferentes.
python --version
python -m pip install -r requirements.txt
python example.pyLa instalación requiere conexión a Internet. BASE establece las rutas de entrada y salida a partir de la ubicación de example.py, no de la ubicación actual de la terminal.
Las fechas se validan con date.fromisoformat y se crea una clave mensual en formato YYYY-MM. Las horas se suman con Decimal y se registran en la tabla con dos decimales. Solo se convierten a números de coma flotante al dibujar el gráfico. Se usa el modo Agg, por lo que se guarda un PNG en lugar de abrir una ventana de gráfico.
"""Summarize fictional work-log records by calendar month."""
import csv
import math
from collections import defaultdict
from datetime import date
from decimal import Decimal, InvalidOperation
from pathlib import Path
import matplotlib
matplotlib.use("Agg")
import matplotlib.pyplot as plt
BASE = Path(__file__).resolve().parent
HEADERS = ["record_id", "date", "task", "hours"]
def main():
destination = BASE / "outputs"
if destination.exists():
raise ValueError("outputs already exists; rename it before running again.")
totals = defaultdict(lambda: {"records": 0, "hours": Decimal("0")})
seen = set()
with (BASE / "work_log.csv").open(encoding="utf-8-sig", newline="") as file:
reader = csv.DictReader(file)
if reader.fieldnames != HEADERS:
raise ValueError(f"Expected headers: {HEADERS}")
for line, row in enumerate(reader, start=2):
if None in row or any(value is None or not value.strip() for value in row.values()):
raise ValueError(f"Row {line}: missing or extra field.")
if row["record_id"] in seen:
raise ValueError(f"Row {line}: duplicate record_id.")
seen.add(row["record_id"])
parsed_date = date.fromisoformat(row["date"])
if parsed_date.isoformat() != row["date"]:
raise ValueError(f"Row {line}: use YYYY-MM-DD dates.")
try:
hours = Decimal(row["hours"])
except InvalidOperation as error:
raise ValueError(f"Row {line}: hours must be a number.") from error
if not hours.is_finite() or hours < 0 or hours.as_tuple().exponent < -2:
raise ValueError(f"Row {line}: hours must be finite, nonnegative, with at most 2 decimals.")
month = parsed_date.strftime("%Y-%m")
totals[month]["records"] += 1
totals[month]["hours"] += hours
if not totals:
raise ValueError("No work records were found.")
months = sorted(totals)
figure, axis = plt.subplots(figsize=(8, 4.6), layout="constrained")
values = [float(totals[month]["hours"]) for month in months]
if not all(math.isfinite(value) and math.isfinite(value * 1.2) for value in values):
plt.close(figure)
raise ValueError("Monthly total is too large to plot as a finite number.")
bars = axis.bar(months, values, color="#2B6578", width=0.55)
axis.bar_label(bars, labels=[f"{value:.2f}" for value in values], padding=4)
axis.set(title="Monthly work hours | Fictional data", xlabel="Calendar month", ylabel="Hours")
axis.set_ylim(0, max(values) * 1.2 if max(values) > 0 else 1)
axis.spines[["top", "right"]].set_visible(False)
axis.set_axisbelow(True)
axis.grid(axis="y", alpha=0.2)
destination.mkdir(exist_ok=False)
with (destination / "monthly_summary.csv").open("x", encoding="utf-8-sig", newline="") as file:
writer = csv.writer(file)
writer.writerow(["month", "record_count", "total_hours"])
for month in months:
writer.writerow([month, totals[month]["records"], f"{totals[month]['hours']:.2f}"])
figure.savefig(destination / "monthly_hours.png", dpi=160)
plt.close(figure)
total_hours = sum((values["hours"] for values in totals.values()), Decimal("0"))
print(f"Records: {len(seen)}; months: {len(months)}; hours: {total_hours:.2f}")
print("Created outputs/monthly_summary.csv and outputs/monthly_hours.png.")
if __name__ == "__main__":
try:
main()
except (OSError, ValueError, csv.Error) as error:
raise SystemExit(f"Stopped: {error}") from error
Se crean outputs/monthly_summary.csv y outputs/monthly_hours.png. El gráfico muestra solo los meses con datos de entrada, ordenados por año y mes. Se han elegido ejes en inglés para poder ejecutar sin instalar fuentes coreanas adicionales.
| month | record_count | total_hours |
|---|---|---|
| 2026-01 | 3 | 6.50 |
| 2026-02 | 3 | 7.50 |
| 2026-03 | 3 | 9.50 |
| Total general de comprobación | 9 | 23.50 |
| Problema | Cómo corregirlo |
|---|---|
| duplicate record_id | Comprueba si has introducido el mismo registro dos veces. |
| day is out of range / Invalid isoformat | Revisa si hay fechas imposibles, como 2026-02-30, o formatos de fecha incorrectos. |
| hours must be a number | Introduce solo números para las horas, como 2.5. Elimina las unidades de tiempo y las comas de separación de miles. |
| hours must be finite… | Busca valores negativos, NaN, Infinity o valores con tres o más decimales. |
| Los caracteres coreanos se muestran mal | Vuelve a guardar el CSV original en UTF-8. |
| outputs already exists | Conserva los resultados anteriores y cambia el nombre de la carpeta de resultados. |
Windows 11 (10.0.26200), CPython 3.12.14 (64 bits). openpyxl 3.1.5, Matplotlib 3.10.8. Las versiones de las bibliotecas usadas en cada ejemplo están fijadas en requirements.txt.
Incluye código, datos de entrada e instrucciones de ejecución. Extrae el ZIP y lee primero README.txt.
Descargar ZIP de ejemploEl código de ejemplo, los nombres de archivo y las claves de entrada se mantienen como en el original. Consulta también los comandos y los pasos de comprobación del texto traducido.
Material de práctica original · Guarda los archivos originales por separado antes de ejecutarlo.
Las explicaciones y los ejemplos son de elaboración propia. Puedes consultar los comportamientos y conceptos relacionados en las siguientes fuentes oficiales.