公司团建占用员工休息时间是否合法，主要取决于团建活动的性质、员工的意愿以及公司是否提供了相应的补偿。以下从不同角度为您详细分析：
一、一般情形下可能不合法
认定为加班的情形：
- 如果团建活动被公司强制要求参加，从法律角度可视为工作内容的一部分。根据《中华人民共和国劳动法》，国家实行劳动者每日工作时间不超过八小时、平均每周工作时间不超过四十四小时的工时制度。团建占用休息时间即延长了工作时间，应被视为加班。
- 依据《劳动法》相关规定，用人单位因生产经营需要延长工作时间的，需与工会和劳动者协商，且不得违反工时限制。同时，安排加班需支付相应的加班费。
- 若公司强制员工参加团建且不支付加班费或不安排补休，则违反了劳动法律法规，侵犯了员工的合法权益。
侵犯员工休息权：
- 休息权是劳动者的基本权利，受法律保护。《宪法》明确规定劳动者有休息的权利。公司强制占用员工休息时间进行团建，剥夺了员工的正常休息和恢复体力、精力的机会，构成对休息权的侵犯。
二、特殊情形下可能合法
员工自愿参加：
- 若团建活动是公司组织但员工可以自主选择是否参加，非强制要求，则在员工自愿参与的情况下，占用休息时间合法。因为此时员工的自主意愿得到了尊重，不存在公司侵犯员工权益的问题。
团建性质属于福利活动且无强制要求：
- 如果团建活动具有浓厚的福利性质，如公司组织员工旅游、聚餐等，且未对员工进行工作安排或业绩考核，员工可以自由决定是否参加，这种团建虽占用休息时间，但通常不被视为违法。因为此类活动旨在增强团队凝聚力、提升员工福利，而非强制性的工作任务。
三、实际操作建议与法律后果
- 公司应合理安排团建时间：避免占用员工的正常工作时间或休息休假时间进行团建活动。如需在工作时间外进行，应提前与员工沟通并征得同意。
- 尊重员工意愿：团建活动的安排应充分考虑员工的意愿和兴趣，确保活动的趣味性和参与性，不应成为员工的额外负担。
- 提供相应补偿：如团建活动确实需要占用员工的休息休假时间，公司应提前向员工说明情况，并提供相应的补偿措施，如支付加班费、延长休假时间等。若公司未提供补偿，员工有权要求公司支付加班费或安排补休，甚至可以通过法律途径维护自己的权益。
- 完善规章制度：公司应在规章制度中明确团建活动的相关规定，包括时间安排、参与方式、补偿措施等，以确保活动的合法性和合规性。
四、若公司违法，员工如何维权
- 与公司协商：员工可以先尝试与公司协商，要求公司支付加班费或安排补休。
- 向劳动监察部门投诉：若协商无果，员工可以向当地的劳动监察部门投诉，请求劳动监察部门介入调查并处理。
- 申请劳动仲裁：员工还可以向劳动合同履行地或用人单位所在地的劳动争议仲裁委员会申请仲裁，要求公司支付加班费或承担其他法律责任。
综上所述，公司团建占用员工休息时间是否合法需根据具体情况判断。公司应遵守相关法律规定，尊重员工权益，合理安排团建活动时间和方式，并提供必要的补偿措施以确保活动的合法性和员工的满意度。若您在此方面遇到任何问题或需要进一步的法律帮助，请随时向我咨询。